FrameworkElement.Height Propiedad

Definición

Obtiene o establece el alto sugerido del 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 de propiedad

Alto del elemento, en unidades independientes del dispositivo (1/96 pulgadas por unidad). El valor predeterminado es NaN. Este valor debe ser igual o mayor que 0,0.

Atributos

Comentarios

Height es una de las tres propiedades grabables de FrameworkElement que especifican información de alto. Los otros dos son MinHeight y MaxHeight. Si hay un conflicto entre estos valores, el orden de aplicación para la determinación de altura real es que primero MinHeight se debe respetar, después MaxHeighty, por último, si está dentro de los límites, Height.

Si este elemento es un elemento secundario dentro de algún otro elemento, establecer esta propiedad en un valor es realmente solo un valor sugerido. El sistema de diseño, así como la lógica de diseño concreta del elemento primario, usarán el valor como una entrada de no enlace durante el proceso de diseño. En términos prácticos, un FrameworkElement es casi siempre el elemento secundario de otra cosa; incluso cuando se establece en WindowHeight . (Para Window, ese valor se usa cuando el modelo de aplicación subyacente establece las suposiciones básicas de representación que crean el Hwnd que hospeda la aplicación).

Además de valores aceptables Double , esta propiedad también puede ser Double.NaN. Así es como se especifica el comportamiento de ajuste de tamaño automático en el código. En XAML, estableces el valor en la cadena "Auto" (sin distinción entre mayúsculas y minúsculas) para habilitar el comportamiento de ajuste de tamaño automático. El comportamiento de ajuste de tamaño automático implica que el elemento rellenará el alto disponible para él. Sin embargo, tenga en cuenta que los controles específicos proporcionan con frecuencia valores predeterminados a través de sus estilos de tema predeterminados que deshabilitarán el comportamiento de ajuste de tamaño automático a menos que se vuelva a habilitar específicamente.

El valor devuelto de esta propiedad siempre es el mismo que cualquier valor establecido en ella. En cambio, el valor de ActualHeight puede variar. Esto puede ocurrir estáticamente porque el diseño rechazó el tamaño sugerido por algún motivo o momentáneamente. El propio sistema de diseño funciona de forma asincrónica en relación con el conjunto del sistema de propiedades de Height y es posible que aún no haya procesado ese cambio de propiedad de ajuste de tamaño determinado.

Un mecanismo aplica ValidateValueCallback las restricciones de valor en el Double valor. Si intenta establecer un valor no válido, se produce una excepción en tiempo de ejecución.

Además de la comprobación de validación, hay un valor superior no determinista enlazado para Height que aplique el sistema de diseño (es un número muy grande, mayor que Single.MaxValue pero menor que Double.MaxValue). Si supera este límite, el elemento no se representará y no se producirá ninguna excepción. No establezca en Height un valor que sea significativamente mayor que el tamaño máximo de cualquier presentación visual posible, o puede superar este límite superior no determinista.

Uso de atributos XAML

<object Height="double"/>  

o bien

<object Height="qualifiedDouble"/>  

o bien

<object Height="Auto"/>  

Valores XAML

double
Double

Representación de cadena de un Double valor igual o mayor que 0,0. Vea Comentarios para obtener información sobre el límite superior. Este valor se interpreta como una medida de unidad independiente del dispositivo (1/96 pulgadas). Las cadenas no necesitan incluir explícitamente puntos decimales. Por ejemplo, un valor de 1 es aceptable.

qualifiedDouble
Valor doble como se describió anteriormente, seguido de una de las siguientes cadenas de declaración de unidad: px, in, cm, pt.

px (valor predeterminado) es unidades independientes del dispositivo (1/96 pulgadas por unidad)

in es pulgadas; 1in==96px

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

pt es puntos; 1pt==(96/72) px

Auto
Habilita el comportamiento de ajuste automático. Vea la sección Comentarios.

Información sobre propiedades de dependencia

Campo identificador HeightProperty
Propiedades de metadatos establecidas en true AffectsMeasure

Se aplica a

Consulte también