FrameworkElement.Height Propiedad

Definición

Obtiene o establece el alto sugerido de frameworkElement.

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

void Height(double value);
public double Height { get; set; }
var double = frameworkElement.height;
frameworkElement.height = double;
Public Property Height As Double
<frameworkElement Height="double"/>
-or-
<frameworkElement Height="Auto"/>
 

Valor de propiedad

Double

double

La altura, en píxeles del objeto . El valor predeterminado es NaN. Excepto para el valor naN especial, este valor debe ser igual o mayor que 0.

Ejemplos

En este ejemplo se muestra un conjunto de propiedades simple de un elemento de interfaz de usuario que se crea en tiempo de ejecución y necesita inicialización de su contenido y propiedades de presentación básicas, como Height y Width y Background. (Background es realmente una propiedad Control , no definida por FrameworkElement).

Button button2 = new Button();
button2.Height = 50;
button2.Width = 100;
button2.Background = new SolidColorBrush(Colors.Blue);
button2.Content = "Click Me";
Dim button2 As Button = New Button
button2.Height = 50
button2.Width = 100
button2.Background = New SolidColorBrush(Colors.Blue)
button2.Content = "Click Me"

Comentarios

Height es una de las 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 la determinación de altura real es que se debe respetar primero MinHeight , después MaxHeight y, por último, si está dentro de los límites, Height.

Varios de los tipos derivados frameworkElement también se derivan de Shape. No todas las clases Shape usan Height o Width para especificar su apariencia y, en su lugar, usan propiedades específicas que podrían definir un conjunto de puntos. En este caso, se calcula un alto o ancho , pero normalmente no se establece directamente.

Las clases personalizadas pueden tener consideraciones similares en las que la clase puede tener propiedades que sean más significativas para especificar dimensiones de las que son Height o Width. Height o Width siguen estando disponibles como miembros y son configurables.

El objeto donde se establecen las propiedades Height o Width es casi siempre un objeto secundario de la colección secundaria de otro elemento primario y establecer Height o Width en un valor es solo un valor sugerido para el proceso de diseño. El sistema de diseño, así como la lógica de diseño determinada de la clase primaria, usará el valor como entrada sin enlace durante el proceso de diseño y es posible que tenga que recortar, cambiar el tamaño del objeto, cambiar el tamaño del contenedor o alguna combinación de estos comportamientos que abarque varios objetos participantes en el diseño. El margen y el relleno también influyen en el tamaño disponible. Para obtener más información, consulta alineación, margen y espaciado.

El valor devuelto de esta propiedad siempre es el mismo que cualquier valor establecido en ella. En cambio, el valor de la propiedad ActualHeight puede variar. La varianza puede producirse estáticamente, ya que el diseño rechazó el tamaño sugerido o momentáneamente. El propio sistema de diseño funciona de forma asincrónica con respecto al conjunto de propiedades de Height del sistema de propiedades y es posible que el sistema de diseño aún no haya procesado ese cambio de propiedad de ajuste de tamaño.

No se permiten valores negativos para Height.

Además, no establezca Height en un valor que sea significativamente mayor que el tamaño máximo de cualquier presentación visual posible.

"Auto" y NaN

El valor predeterminado de Height y Width es "Auto", representado por NaN. En el marcado XAML, puedes usar la cadena "Auto" para establecer el valor en NaN.

Nota

En C#, puede obtener NaN de Double.NaN.

En C++, puede obtener NaN mediante la NAN macro o std::numeric_limits<double>::quiet_NaN().

No use el == operador para probar NaN.

En C#, use Double.IsNaN() para probar NaN.

En C++, use isnan() para probar NaN.

El sistema de diseño interpreta el valor "Automático" para, por lo general, significa que el objeto debe tener el tamaño disponible en el diseño, en lugar de en un valor de píxel específico.

Se aplica a

Consulte también