Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Propiedad FrameworkElement.Height

 

Publicado: noviembre de 2016

Obtiene o establece el alto sugerido del elemento.

Espacio de nombres:   System.Windows
Ensamblado:  PresentationFramework (en PresentationFramework.dll)

[TypeConverterAttribute(typeof(LengthConverter))]
[LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)]
public double Height { get; set; }

Valor de propiedad

Type: System.Double

Alto máximo del elemento, en unidades independientes de dispositivo (1/96 de pulgada por unidad). El valor predeterminado es Double.NaN. Este valor debe ser igual o mayor que 0,0. Vea Comentarios para obtener información sobre el límite superior.

Height es una de tres propiedades grabables en 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 determinar el alto real es que el primero MinHeight debe respetar, a continuación, MaxHeight, y por último, si está dentro de límites, Height.

Si este elemento es un elemento secundario de otro elemento, a continuación, establecer esta propiedad en un valor realmente es sólo un valor sugerido. El sistema de diseño, así como la lógica de diseño concreta del elemento primario se utilizará el valor como entrada no enlazada durante el proceso de diseño. En términos prácticos, un FrameworkElement casi siempre es el elemento secundario de otro; incluso cuando se configuran los Height en Window. (Para Window, que el valor se utiliza cuando el modelo de aplicación subyacente establece las suposiciones de representación básicas que crean el Hwnd que hospeda la aplicación.)

Además de a aceptable Double valores, esta propiedad también puede ser Double.NaN. Se trata cómo especificar el comportamiento de ajuste de tamaño automático en el código. En XAML establece el valor en la cadena "Auto" (no distingue mayúsculas de minúsculas) para habilitar el comportamiento de ajuste de tamaño de automático. Comportamiento de ajuste de tamaño automático implica que el elemento rellenará el alto disponible para él. Sin embargo, tenga en cuenta que controles concretos proporcionan frecuentemente valores predeterminados a través de sus estilos de tema predeterminados, que deshabilitan el comportamiento de ajuste de tamaño a menos que se vuelva a habilitar específicamente de automático.

El valor devuelto de esta propiedad es siempre igual que cualquier valor que estuviera establecido en ella. En cambio, el valor de la ActualHeight puede variar. Esto puede ocurrir estáticamente, porque el diseño rechazó el tamaño sugerido por alguna razón, o momentáneamente. El propio sistema de diseño funciona de forma asincrónica con respecto al conjunto del sistema de propiedades de Height y no haber procesado que determinado todavía de cambio de propiedad de tamaño.

Las restricciones de valor en el Double valor exige una ValidateValueCallback mecanismo. Si se 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 se aplica el sistema de diseño (se trata de un número muy grande, mayor que Single.MaxValue pero menor que Double.MaxValue). Si supera este límite, el elemento no se procesará y se inicia ninguna excepción. No establezca Height en un valor significativamente mayor que el tamaño máximo de cualquier posible presentación visual, o bien puede superar este límite superior no determinista.

<object Height="double"/>
- or -
<object Height="qualifiedDouble"/>
- or -
<object Height="Auto"/>

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 un unidad independiente de dispositivo (1/96 de pulgada) medida. Las cadenas no necesitan incluir explícitamente separadores decimales. Por ejemplo, un valor de 1 es aceptable.

qualifiedDouble

Un doble valor, como se describió anteriormente, seguido de una de las siguientes cadenas de declaración de unidades: px, in, cm, pt.

px (valor predeterminado) es unidades independientes de dispositivo (1/96 de pulgada por unidad)

in pulgadas; 1 in == 96 px

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

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

Automático

Habilita el comportamiento de ajuste automático de tamaño. Vea la sección Comentarios.

Campo identificador

HeightProperty

Propiedades de metadatos se establecen en true

AffectsMeasure

.NET Framework
Disponible desde 3.0
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Volver al principio
Mostrar: