Informações
O tópico solicitado está sendo mostrado abaixo. No entanto, este tópico não está incluído nesta biblioteca.

Propriedade FrameworkElement.Height

Obtém ou define a altura sugerida do elemento.

Namespace:  System.Windows
Assembly:  PresentationFramework (em 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)]
public double Height { get; set; }
<object Height="double"/>
- or -
<object Height="qualifiedDouble"/>
- or -
<object Height="Auto"/>

Valores XAML

double

Double

Representação de cadeia de caracteres de um valor de Double igual a ou maior que 0,0. Consulte comentários para informações do limite superior. Esse valor é interpretado como uma medida de unidade independente de dispositivo (1/96 polegada) . As cadeias de caracteres não precisam incluir explicitamente de pontos decimais. Por exemplo um valor de 1 é aceitável.

qualifiedDouble

Um valor double conforme descrito acima, seguido por uma a seguinte declaração da unidade cadeia de caracteres: px, in, cm, pt.

px (padrão) é unidades independentes de dispositivo (1/96 polegada por unidade)

in é polegadas; 1in==96px

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

pt é pontos; (96/72) de px 1pt==

Automático

Ativar comportamento auto-dimensionamento. Consulte Comentários.

Valor de propriedade

Tipo: System.Double
A altura do elemento, em unidades independentes de dispositivo (1/96 polegada por unidade). O valor padrão é Double.NaN. Este valor deve ser igual a ou maior que 0,0. Consulte comentários para informações do limite superior.

Campo identificador

HeightProperty

Propriedades de metadados definidas como true

AffectsMeasure

Height é uma das três propriedades modificável em FrameworkElement que especificam informações de altura. Os outros dois são MinHeight e MaxHeight. Se houver um conflito entre esses valores, a ordem de aplicativo para determinar real da altura é a primeira MinHeight deve ser aceito, então MaxHeight, e finalmente, se está dentro dos limites, Height.

Se esse elemento é um elemento filho dentro de qualquer outro elemento, então defina essa propriedade para um valor é realmente apenas um valor sugerido. O sistema de layout bem como a lógica específica de layout do elemento pai usarão o valor como uma entrada nonbinding durante o processo de layout. Em termos práticos, FrameworkElement é quase sempre o elemento filho de algo; mesmo quando você define Height em Window. (Para Window, esse valor é usado quando o modelo subjacente de aplicativo para determinar as suposições básicas de renderização que cria o Hwnd que hospeda o aplicativo.)

Além de valores aceitáveis de Double , essa propriedade também pode ser Double.NaN. Isso é como você especifica o comportamento de dimensionamento automático no código. Em XAML você define o valor da cadeia de caracteres “carro” (sem diferenciação de maiúsculas e minúsculas) para ativar o comportamento de dimensionamento automático. O comportamento de dimensionamento automático significa que o elemento a preencherá a altura disponível. Observe entretanto que os controles específicos geralmente fornecem valores padrão com os estilos de tema padrão que desabilitarão o comportamento de dimensionamento automático a menos que novamente for ativado especificamente.

O valor de retorno dessa propriedade é sempre o mesmo que qualquer valor que ela é definido. Em contraste, o valor de ActualHeight pode variar. Isso pode acontecer qualquer um estaticamente porque o layout rejeitou o tamanho sugerido por algum motivo, ou rapidamente. O próprio sistema de layout funciona de forma assíncrona relativo ao sistema de propriedade set de Height e não pode ter processado que a propriedade específico de dimensionamento se altera ainda.

As restrições de valor no valor de Double são aplicadas por um mecanismo de ValidateValueCallback . Se você tentar definir um valor inválido, uma exceção de tempo de execução é lançada.

Além da verificação de validação, há um valor maior nondeterministic associado para Height que é imposta pelo sistema de layout (esse é um grande número, maior do que Single.MaxValue mas menores do que Double.MaxValue). Se você exceder esse limite, o elemento não irá processar, e nenhuma exceção é lançada. Não defina Height para um valor que é significativamente maior do que o tamanho máximo de qualquer exibição visual possível, ou você pode exceder esse limite superior nondeterministic.

Este exemplo mostra visualmente as diferenças de comportamento de renderização entre as quatro propriedades relacionadas à altura do Windows Presentation Foundation (WPF).

A classe FrameworkElement expõe quatro propriedades que descrevem as características de altura de um elemento. Essas quatro propriedades podem conflitar, e quando o fazem, o valor que tem precedência é determinado como segue: o valor MinHeight tem precedência sobre o valor MaxHeight, que por sua vez tem precedência sobre o valor Height. Uma propriedade de quarta, ActualHeight, é somente leitura e relata a altura real conforme determinado por interações com o processo de layout.

O exemplo de Extensible Application Markup Language (XAML) a seguir desenha um elemento Rectangle (rect1) como um filho de Canvas. Você pode alterar as propriedades de altura de um Rectangle , usando uma série de ListBox elementos que representam os valores de propriedade de MinHeight, MaxHeight, e Height. Dessa forma, a precedência de cada propriedade é exibida 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>


Os exemplos de code-behind a seguir manipulam os eventos que o evento SelectionChanged dispara. Cada manipulador leva a entrada da ListBox, analisa o valor como um Doublee aplica o valor à propriedade relacionados à altura especificada. Os valores de altura são também convertidos em uma seqüência de caracteres e gravados em várias TextBlock elementos (definição desses elementos não é mostrada no XAML selecionado).


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 obter o exemplo completo, consulte Exemplo de propriedades de altura.

.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

Mostrar:
© 2014 Microsoft