FrameworkElement.Height-Eigenschaft

Height ist eine von drei schreibbaren Eigenschaften für FrameworkElement, die Informationen zur Höhe angeben. Die anderen beiden sind MinHeight und MaxHeight. Wenn ein Konflikt zwischen diesen Werten vorhanden sind, ist die Reihenfolge der Anwendung für tatsächliche Höhe bestimmung, dass zuerst MinHeight beachtet werden muss, und schließlich MaxHeight, wenn sie innerhalb der Grenzen liegt, Height.

Wenn dieses Element ein untergeordnetes Element innerhalb eines anderen Elements ist, dann wird diese Eigenschaft auf einen Wert festzulegen ist nur ein vorgeschlagener Wert. Das Layoutsystem als auch die spezifische Logik Layout des übergeordneten Elements verwenden den Wert als Eingabe nonbinding während des Prozesses Layout. Praktisch handelt FrameworkElement fast immer das untergeordnete Element etwas Anderes; Auch wenn Sie festgelegt Height auf Window. (Eine Window, wird dieser Wert verwendet, wenn das zugrunde liegende Anwendungsmodell die grundlegenden Rendering annahmen einrichtet, die das die Anwendung hostet Hwnd) erstellen.

Zusätzlich zu zulässigen Werten Double Diese Eigenschaft kann Double.NaNwerden. Dies ist, wie Sie das automatische Größenanpassungsverhalten im Code angeben. In XAML legen Sie den Wert auf die Zeichenfolge „Auto“ (ohne Berücksichtigung von Groß- und Kleinschreibung), um den automatischen Größenanpassung kann zu aktivieren. Automatisches Größenanpassungsverhalten bedeutet, dass die Höhe des Elements ausgefüllt werden dorthin verfügbar. Beachten Sie jedoch Standardwerte dieses den bestimmten Steuerelementen häufig durch ihre Standardeinstellung Designstile, die das automatische Größenanpassungsverhalten deaktivieren, es sei denn, es wird ausdrücklich wieder aktiviert.

Der Rückgabewert dieser Eigenschaft ist immer derselbe wie ein beliebiger Wert, der dorthin festgelegt wurde. Im Gegensatz dazu wird der Wert möglicherweise ActualHeight. Dies kann statisch, da das Layout die vorgeschlagene Größe aus irgendeinem Grund zurückwies oder kurzzeitig geschehen ein. Das Layoutsystem selbst funktioniert asynchron relativ zu dem Eigenschaftensystem, das von Height festgelegt ist und nicht verarbeitet werden, dass bestimmte Eigenschaft der Größenanpassung noch ändern.

Die Wertbeschränkungen auf dem Double-Wert werden durch einen ValidateValueCallback Weise erzwungen. Wenn Sie versuchen, einen ungültigen Wert festzulegen, wird eine Laufzeitausnahme ausgelöst.

Zusätzlich zur Validierung gibt es einen nicht deterministisch oberen Wert, der für Height gebunden ist, der durch das Layoutsystem erzwungen wird (dieser handelt es sich um eine sehr große Zahl größer als Single.MaxValue jedoch ein kleiner als Double.MaxValue). Wenn Sie diese Grenze überschreiten, rendert das Element nicht angezeigt, und es wird keine Ausnahme ausgelöst. Legen Sie Height nicht auf einen Wert fest, der die maximale Größe erheblich größer als jeder beliebigen visuelle Darstellung ist oder Sie können diese Obergrenze überschreiten nicht deterministisch.

In diesem Beispiel werden die Unterschiede im Renderingverhalten zwischen den vier höhenbezogenen Eigenschaften in Windows Presentation Foundation (WPF) visuell veranschaulicht.

Die Höhenmerkmale eines Elements werden von vier Eigenschaften beschrieben, die von der FrameworkElement-Klasse verfügbar gemacht werden. Diese vier Eigenschaften können zu Konflikten führen. Sollte dies der Fall sein, wird der vorrangige Wert folgendermaßen definiert: Der MinHeight-Wert hat Vorrang vor dem MaxHeight-Wert, der wiederum Vorrang vor dem Height-Wert hat. Eine vierte Eigenschaft, ActualHeight, ist schreibgeschützt und meldet die tatsächliche Höhe, wie von Interaktionen mit dem Layoutprozess bestimmt.

In den folgenden Extensible Application Markup Language (XAML)-Beispielen wird ein Rectangle-Element (rect1) als untergeordnetes Element der Canvas dargestellt. Die Höheneigenschaften von einem Rectangle können mithilfe einer Reihe von ListBox-Elementen geändert werden, die die Eigenschaftswerte von MinHeight, MaxHeight und Height darstellen. Auf diese Weise wird die Rangfolge jeder Eigenschaft visuell angezeigt.

<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>

In den folgenden CodeBehind-Beispielen werden die Ereignisse behandelt, die das SelectionChanged-Ereignis auslöst. Jeder Handler übernimmt die Eingabe aus ListBox, analysiert den Wert als Double und wendet den Wert auf die angegebene höhenbezogene Eigenschaft an. Die Höhenwerte werden außerdem in eine Zeichenfolge konvertiert und in verschiedene TextBlock-Elemente geschrieben (die Definition dieser Elemente wird nicht im ausgewählten XAML angezeigt).

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;
}

Das vollständige Beispiel finden Sie unter Beispiel für Height-Eigenschaften.

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz

Weitere Ressourcen