FrameworkElement.Height Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Obtém ou define a altura sugerida do elemento.

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 da propriedade

Double

A altura do elemento, em unidades independentes do dispositivo (1/96 polegada por unidade). O valor padrão é NaN. Este valor deve ser igual ou maior que 0,0.

Atributos

TypeConverterAttribute LocalizabilityAttribute

Comentários

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

Se esse elemento for um elemento filho dentro de algum outro elemento, definir essa propriedade como um valor será, na verdade, apenas um valor sugerido. O sistema de layout, bem como a lógica de layout específica do elemento pai, usarão o valor como uma entrada não vinculada durante o processo de layout. Em termos práticos, um FrameworkElement é quase sempre o elemento filho de outra coisa; mesmo quando você define o Height em Window. (Para Window, esse valor é usado quando o modelo de aplicativo subjacente estabelece as suposições básicas de renderização que criam o Hwnd que hospeda o aplicativo.)

Além dos valores aceitáveis Double , essa propriedade também pode ser Double.NaN. É assim que você especifica o comportamento de dimensionamento automático no código. No XAML, você define o valor como a cadeia de caracteres "Auto" (não diferencia maiúsculas de minúsculas) para habilitar o comportamento de dimensionamento automático. O comportamento de dimensionamento automático implica que o elemento preencherá a altura disponível para ele. Observe, no entanto, que controles específicos frequentemente fornecem valores padrão por meio de seus estilos de tema padrão que desabilitam o comportamento de dimensionamento automático, a menos que ele seja especificamente reabilitado.

O valor retornado dessa propriedade é sempre o mesmo que qualquer valor que foi definido para ela. Por outro lado, o valor do ActualHeight pode variar. Isso pode acontecer estaticamente 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 e pode não ter processado essa alteração de propriedade de dimensionamento específica ainda.

As restrições de valor no Double valor são impostas por um ValidateValueCallback mecanismo. Se você tentar definir um valor inválido, uma exceção em tempo de execução será gerada.

Além da validação marcar, há um valor superior não determinístico associado a Height que é imposto pelo sistema de layout (esse é um número muito grande, maior queSingle.MaxValue, mas menor que Double.MaxValue). Se você exceder esse limite, o elemento não será renderizado e nenhuma exceção será gerada. Não defina Height como um valor significativamente maior que o tamanho máximo de qualquer exibição visual possível ou você pode exceder esse limite superior não determinístico.

Uso do Atributo XAML

<object Height="double"/>  

- ou -

<object Height="qualifiedDouble"/>  

- ou -

<object Height="Auto"/>  

Valores XAML

double
Double

Representação de cadeia de caracteres de um Double valor igual ou maior que 0,0. Consulte os Comentários para ver informações sobre o limite superior. Esse valor é interpretado como uma medida de unidade independente do dispositivo (1/96 polegada). As cadeias de caracteres não precisam incluir explicitamente pontos decimais. Por exemplo, um valor de 1 é aceitável.

Qualifieddouble
Um valor duplo, conforme descrito acima, seguido por uma das seguintes cadeias de caracteres de declaração de unidade: px, in, cm, . pt

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

in é polegadas; 1in==96px

cm é centímetro; 1cm==(96/2,54) px

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

Automático
Habilita o comportamento de dimensionamento automático. Consulte Observações.

Informações da propriedade de dependência

Campo Identificador	HeightProperty
Propriedades de metadados definidas como true	AffectsMeasure

Confira também

• ActualHeight