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

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

Atributos

TypeConverterAttribute LocalizabilityAttribute

Comentários

Height é uma das três propriedades graváveis que especificam informações de FrameworkElement 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 e, MaxHeightpor 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 vinculante 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 .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. No entanto, observe que controles específicos frequentemente fornecem valores padrão por meio de seus estilos de tema padrão que desabilitarão o comportamento de dimensionamento automático, a menos que ele esteja especificamente habilitado novamente.

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 do sistema de Height propriedades 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 verificação de validação, há um valor superior não determinístico associado ao Height que é imposto pelo sistema de layout (esse é um número muito grande, maior que Single.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

DuploDouble

Representação de cadeia de caracteres de um Double valor igual ou maior que 0,0. Consulte Comentários para obter informações de 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ímetros; 1cm==(96/2,54) px

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

Automático Habilita o comportamento de dimensionamento automático. Consulte Comentários.

Informações da propriedade Dependency

Confira também

• ActualHeight