FrameworkElement.Height Propriedade

public:
 property double Height { double get(); void set(double value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public double Height { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Height : double with get, set

Public Property Height As Double

Valor de Propriedade

A altura do elemento, em unidades independentes do dispositivo (1/96 de polegada por unidade). O valor predefinido é NaN. Este valor deve ser igual ou superior a 0,0.

Atributos

TypeConverterAttribute LocalizabilityAttribute

Observações

Height é uma das três propriedades graváveis que FrameworkElement especificam a informação de altura. Os outros dois são MinHeight e MaxHeight. Se houver um conflito entre estes valores, a ordem de aplicação para a determinação real da altura é que primeiro MinHeight deve ser respeitada, depois MaxHeight, e finalmente, se estiver dentro dos limites, Height.

Se este elemento for um elemento filho dentro de outro elemento, então definir esta propriedade como valor é realmente apenas um valor sugerido. O sistema de layout, assim como a lógica de layout particular do elemento pai, usarão o valor como uma entrada não vinculativa durante o processo de layout. Em termos práticos, a FrameworkElement é quase sempre o elemento filho de outra coisa; mesmo quando se define em HeightWindow. (Para Window, esse valor é usado quando o modelo de aplicação subjacente estabelece as suposições básicas de renderização que criam o Hwnd que hospeda a aplicação.)

Para além dos valores aceitáveis Double , esta propriedade também pode ser Double.NaN. É assim que se especifica o comportamento de autodimensionamento no código. No XAML, defines o valor para a string "Auto" (indistinto a maiúsculas minúsculas) para ativar o comportamento de autodimensionamento. O comportamento de autodimensionamento implica que o elemento irá preencher a altura disponível. Note-se, no entanto, que determinados controlos frequentemente fornecem valores predefinidos através dos seus estilos de tema predefinidos, o que desativa o comportamento de autodimensionamento, a menos que seja especificamente reativado.

O valor de retorno desta propriedade é sempre o mesmo que qualquer valor que lhe foi atribuído. Em contraste, o valor do ActualHeight pode variar. Isto pode acontecer de forma estática porque o layout rejeitou o tamanho sugerido por algum motivo, ou momentaneamente. O próprio sistema de layout funciona de forma assíncrona em relação ao conjunto de Height propriedades do sistema de propriedades e pode ainda não ter processado essa alteração específica de propriedade de dimensionamento.

As restrições de valor ao Double valor são aplicadas por um ValidateValueCallback mecanismo. Se tentar definir um valor inválido, é lançada uma exceção em tempo de execução.

Além da verificação de validação, existe um limite superior de valor não determinístico para Height que é imposto pelo sistema de layout (este é um número muito grande, maior que Single.MaxValue mas menor que Double.MaxValue). Se ultrapassar este limite, o elemento não será renderizado, e não é feita nenhuma exceção. Não defina Height um valor significativamente maior do que o tamanho máximo de qualquer possível exibição visual, ou poderá exceder este limite superior não determinístico.

Uso de atributos XAML

<object Height="double"/>

-ou-

<object Height="qualifiedDouble"/>

-ou-

<object Height="Auto"/>

Valores XAML

DuploDouble

Representação de cadeias de valor Double igual ou superior a 0,0. Consulte Observações para informações sobre o limite superior. Este valor é interpretado como uma medição unitária independente do dispositivo (1/96 de polegada). As cadeias não precisam de incluir explicitamente pontos decimais. Por exemplo, um valor de 1 é aceitável.

Duplo qualificado Um valor duplo como descrito acima, seguido de uma das seguintes cadeias de declaração unitária: px, in, cm, pt.

px (por defeito) são unidades independentes do dispositivo (1/96 de polegada por unidade)

in é de polegadas; 1in==96px

cm é centímetros; 1cm==(96/2.54) px

pt é pontos; 1pt==(96/72) px

Automóvel Permite o comportamento de autodimensionamento. Ver Observações.

Informação de Propriedade de Dependência

Ver também

• ActualHeight