FrameworkElement.Height (Propiedad)

Height es una de tres propiedades programables en FrameworkElement que especifican la información de alto. los otros dos son MinHeight y MaxHeight. Si hay un conflicto entre estos valores, el orden de la aplicación para determinar real height es que primer MinHeight debe ser prioridad, después MaxHeighty, por último, si está dentro de los límites, Height.

Si este elemento es un elemento secundario de otro elemento, y establecer esta propiedad en un valor en realidad es solamente un valor sugerido. El sistema de diseño con la lógica concreta del diseño del elemento primario utilizarán el valor como entrada nonbinding durante el proceso de diseño. En la práctica, FrameworkElement casi siempre es el elemento secundario de algo más; incluso cuando se establece Height en Window. (Para Window, se utiliza ese valor al modelo subyacente de la aplicación establece las hipótesis básicas de representación que crean el HWND que hospeda la aplicación.)

Además de los valores permitidos de Double , esta propiedad también se puede Double.NaN. Así es cómo se especifica un comportamiento automático de tamaño en código. En XAML establezca el valor en la cadena “auto” (sin distinción entre mayúsculas y minúsculas) para habilitar el comportamiento del tamaño. El comportamiento del tamaño implica que el elemento rellenará el alto disponible al. Observe sin embargo que determinados controles con frecuencia proporcionan los valores predeterminados con sus estilos predeterminados del tema que se deshabilite el comportamiento automático de tamaño a menos que se vuelva a habilitar específicamente.

El valor devuelto de esta propiedad es siempre igual que cualquier valor que estuviera establecido en. en cambio, el valor de ActualHeight puede variar. Esto puede suceder cualquiera 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 en relación con el sistema de propiedades de conjunto de Height y podría no haber procesado que la propiedad concreta de tamaño cambia todavía.

Las restricciones de valor en el 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 comprobar la validación, hay un valor superior no determinista enlazado para Height que es aplicado por el sistema de diseño (esto es un número muy grande, mayores que Single.MaxValue pero menores que Double.MaxValue). Si se superan esto limita, el elemento no generará, y no se produce ninguna excepción. No establezca Height a un valor que sea significativamente mayor que el tamaño máximo de cualquier representación visual posible, o 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).

private void changeHeight(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem li = ((sender as ListBox).SelectedItem as ListBoxItem);
    Double sz1 = Double.Parse(li.Content.ToString());
    rect1.Height = sz1;
    rect1.UpdateLayout();
    txt1.Text= "ActualHeight is set to " + rect1.ActualHeight;
    txt2.Text= "Height is set to " + rect1.Height;
    txt3.Text= "MinHeight is set to " + rect1.MinHeight;
    txt4.Text= "MaxHeight is set to " + rect1.MaxHeight;
}
private void changeMinHeight(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem li = ((sender as ListBox).SelectedItem as ListBoxItem);
    Double sz1 = Double.Parse(li.Content.ToString());
    rect1.MinHeight = sz1;
    rect1.UpdateLayout();
    txt1.Text= "ActualHeight is set to " + rect1.ActualHeight;
    txt2.Text= "Height is set to " + rect1.Height;
    txt3.Text= "MinHeight is set to " + rect1.MinHeight;
    txt4.Text= "MaxHeight is set to " + rect1.MaxHeight;
}
private void changeMaxHeight(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem li = ((sender as ListBox).SelectedItem as ListBoxItem);
    Double sz1 = Double.Parse(li.Content.ToString());
    rect1.MaxHeight = sz1;
    rect1.UpdateLayout();
    txt1.Text= "ActualHeight is set to " + rect1.ActualHeight;
    txt2.Text= "Height is set to " + rect1.Height;
    txt3.Text= "MinHeight is set to " + rect1.MinHeight;
    txt4.Text= "MaxHeight is set to " + rect1.MaxHeight;
}

Para obtener el ejemplo completo, vea Height Properties Sample.

.NET Framework

.NET Framework Client Profile

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)

Referencia

Otros recursos