Información
El tema que ha solicitado se muestra abajo. Sin embargo, este tema no se encuentra en la biblioteca.

FrameworkElement.Height (Propiedad)

Obtiene o establece el alto sugerido del elemento.

Espacio de nombres:  System.Windows
Ensamblado:  PresentationFramework (en PresentationFramework.dll)
XMLNS para XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

[<TypeConverterAttribute(typeof(LengthConverter))>]
[<LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)>]
abstract Height : float with get, set
[<TypeConverterAttribute(typeof(LengthConverter))>]
[<LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)>]
override Height : float with get, set
<object Height="double"/>
- or -
<object Height="qualifiedDouble"/>
- or -
<object Height="Auto"/>

Valores XAML

double

Double

Representación de cadena de un valor de tipo Double igual o mayor que 0,0. Vea la sección Comentarios para obtener información sobre los límites superiores. Este valor se interpreta como una medida de unidad independiente de dispositivo (1/96 de pulgada). No es preciso incluir explícitamente separadores decimales en las cadenas. Por ejemplo, el valor 1 es aceptable.

qualifiedDouble

Valor double, descrito 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 significa pulgadas; 1 in==96 px

cm significa centímetros; 1 cm==(96/2,54) px

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

Auto

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

Valor de propiedad

Tipo: System.Double
Alto del elemento, en unidades independientes de dispositivo (1/96 de pulgada por unidad). El valor predeterminado es Double.NaN. Este valor debe ser mayor o igual que 0,0. Vea la sección Comentarios para obtener información sobre los límites superiores.

Campo de identificador

HeightProperty

Propiedades de metadatos establecidas en true.

AffectsMeasure

Height es una de tres propiedades grabables de FrameworkElement que especifican la información de alto. Las otros dos son MinHeight y MaxHeight. Si existe un conflicto entre estos valores, el orden de aplicación para determinar el alto real es: primero se debe aplicar la propiedad MinHeight, después la propiedad MaxHeight y, finalmente, si cada una de ellas está dentro de los límites, la propiedad Height.

Si este elemento es un elemento secundario de algún otro elemento, establecer esta propiedad en un valor es sólo una sugerencia. El sistema de diseño, así como la lógica de diseño concreta del elemento primario, utilizará el valor como entrada no enlazada durante el proceso de diseño. En términos prácticos, FrameworkElement es casi siempre un elemento secundario de otro; incluso al establecer Height en Window. (Para Window, ese valor se usa cuando el modelo de aplicación subyacente establece las asunciones de representación básicas que crean el identificador de ventana (Hwnd) que hospeda la aplicación.)

Además de los valores Double aceptables, esta propiedad también puede ser Double.NaN. Así se especifica el comportamiento de ajuste de tamaño automático en el código. En XAML se establece el valor en la cadena "Automático" (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, observe 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 automático a menos que se vuelva a habilitar específicamente.

El valor devuelto de esta propiedad siempre es igual que cualquier valor que estuviera establecido en ella. Por el contrario, el valor de 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 respecto al conjunto del sistema de propiedades de Height y puede no haber procesado aún esa propiedad de ajuste de tamaño concreta.

Las restricciones del valor de Double se aplican mediante un mecanismo de ValidateValueCallback. 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 la validación, hay un valor superior no determinista enlazado para Height que el sistema de diseño aplica (éste 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 produce ninguna excepción. No establezca Height en un valor significativamente mayor que el tamaño máximo de cualquier posible presentación visual; de lo contrario, puede superar este límite superior no determinista.

En este ejemplo se muestran los distintos comportamientos de representación de las cuatro propiedades de Windows Presentation Foundation (WPF) que están relacionadas con el alto.

La clase FrameworkElement expone cuatro propiedades que describen las características de alto de un elemento. Estas cuatro propiedades pueden generar conflictos y, en ese caso, el valor que tiene prioridad se determina de la manera siguiente: el valor de MinHeight tiene prioridad sobre el valor de MaxHeight, que a su vez tiene prioridad sobre el valor de Height. Una cuarta propiedad, ActualHeight, es de solo lectura y notifica el alto real tal y como se determina por las interacciones con el proceso del diseño.

En los siguientes ejemplos de Lenguaje XAML se dibuja un elemento Rectangle (rect1) como un elemento secundario de Canvas. Puede cambiar las propiedades de alto de una clase Rectangle por medio de una serie de elementos ListBox que representan los valores de propiedad de MinHeight, MaxHeight y Height. De esta manera, la prioridad de cada propiedad se muestra visualmente.


<Canvas Height="200" MinWidth="200" Background="#b0c4de" VerticalAlignment="Top"  HorizontalAlignment="Center" Name="myCanvas" Margin="0,0,0,50">
    <Rectangle HorizontalAlignment="Center" Canvas.Top="50" Canvas.Left="50"  Name="rect1" Fill="#4682b4" Height="100" Width="100"/>
</Canvas>


...


    <TextBlock Grid.Row="1" Grid.Column="0" Margin="10,0,0,0" TextWrapping="Wrap">Set the Rectangle Height:</TextBlock>
    <ListBox Grid.Column="1" Grid.Row="1" Margin="10,0,0,0" Height="50" Width="50" SelectionChanged="changeHeight">
      <ListBoxItem>25</ListBoxItem>
      <ListBoxItem>50</ListBoxItem>
      <ListBoxItem>75</ListBoxItem>
      <ListBoxItem>100</ListBoxItem>
      <ListBoxItem>125</ListBoxItem>
      <ListBoxItem>150</ListBoxItem>
      <ListBoxItem>175</ListBoxItem>
      <ListBoxItem>200</ListBoxItem>
    </ListBox>

	<TextBlock Grid.Row="1" Grid.Column="2" Margin="10,0,0,0" TextWrapping="Wrap">Set the Rectangle MinHeight:</TextBlock>
    <ListBox Grid.Column="3" Grid.Row="1" Margin="10,0,0,0" Height="50" Width="50" SelectionChanged="changeMinHeight">
      <ListBoxItem>25</ListBoxItem>
      <ListBoxItem>50</ListBoxItem>
      <ListBoxItem>75</ListBoxItem>
      <ListBoxItem>100</ListBoxItem>
      <ListBoxItem>125</ListBoxItem>
      <ListBoxItem>150</ListBoxItem>
      <ListBoxItem>175</ListBoxItem>
      <ListBoxItem>200</ListBoxItem>
  </ListBox>      

    <TextBlock Grid.Row="1" Grid.Column="4" Margin="10,0,0,0" TextWrapping="Wrap">Set the Rectangle MaxHeight:</TextBlock>
    <ListBox Grid.Column="5" Grid.Row="1" Margin="10,0,0,0" Height="50" Width="50" SelectionChanged="changeMaxHeight">
      <ListBoxItem>25</ListBoxItem>
      <ListBoxItem>50</ListBoxItem>
      <ListBoxItem>75</ListBoxItem>
      <ListBoxItem>100</ListBoxItem>
      <ListBoxItem>125</ListBoxItem>
      <ListBoxItem>150</ListBoxItem>
      <ListBoxItem>175</ListBoxItem>
      <ListBoxItem>200</ListBoxItem> 
    </ListBox>


Los siguientes ejemplos de código subyacente permiten controlar los eventos que provoca el evento SelectionChanged. Cada controlador toma la entrada de ListBox, analiza el valor como Double y aplica el valor a la propiedad relacionada con el alto especificada. Los valores de alto se convierten también en una cadena y se escriben en varios elementos TextBlock (la definición de esos elementos no se muestra en el código XAML seleccionado).

No hay ningún ejemplo de código disponible o este idioma no es compatible.

Para obtener el ejemplo completo, vea Height Properties Sample.

.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

Mostrar:
© 2014 Microsoft