FrameworkElement.MaxHeight Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml

Ruft die maximale Höheneinschränkung eines FrameworkElement ab oder legt diese fest.

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

double MaxHeight();

void MaxHeight(double value);

public double MaxHeight { get; set; }

var double = frameworkElement.maxHeight;
frameworkElement.maxHeight = double;

Public Property MaxHeight As Double

<frameworkElement MaxHeight="double"/>
 

Eigenschaftswert

Double

double

Die maximale Höhe des Objekts in Pixel. Der Standardwert ist PositiveInfinity. Dieser Wert kann ein beliebiger Wert sein, der gleich oder größer als 0 ist. PositiveInfinity ist ebenfalls gültig.

Beispiele

Dieses XAML-Beispiel zeigt eine Technik zum Angeben eines MaxHeight für ein ViewBox-Objekt. ViewBox ist ein Decorator, der Layoutinformationen auf ein einzelnes untergeordnetes Element anwenden und Layoutbereiche für das nächste übergeordnete Element (in diesem Fall ein StackPanel) teilen kann.

<Grid Height="600" Width="600">
    <Grid.ColumnDefinitions>
        <ColumnDefinition />
        <ColumnDefinition />
    </Grid.ColumnDefinitions>
    
    <Grid.RowDefinitions>
        <RowDefinition Height="Auto" />
        <RowDefinition Height="auto" />
        <RowDefinition />
    </Grid.RowDefinitions>
    
    <StackPanel Grid.Row="0" Grid.Column="0" Margin="5,5,5,5" Orientation="Vertical">
        <TextBlock Text="Stretch" FontWeight="Bold" FontSize="12" />
        <Button Name="btn1" Click="stretchNone" Content="None" />
        <Button Name="btn2" Click="stretchFill" Content="Fill" />
        <Button Name="btn3" Click="stretchUni" Content="Uniform" />
        <Button Name="btn4" Click="stretchUniFill" Content="UniformToFill" />
    </StackPanel>

    <StackPanel Grid.Row="0" Grid.Column="1" Margin="5,5,5,5" Orientation="Vertical">
        <TextBlock Text="StretchDirection" FontWeight="Bold" FontSize="12" />
        <Button Name="btn5" Click="sdUpOnly" Content="UpOnly" />
        <Button Name="btn6" Click="sdDownOnly" Content="DownOnly" />
        <Button Name="btn7" Click="sdBoth" Content="Both" />
    </StackPanel>

    <StackPanel Grid.Row="1" Grid.Column="0" Grid.ColumnSpan="2" Margin="5" 
                Orientation="Vertical">
        <TextBlock Name="txt1" FontSize="12" FontWeight="Bold" />
        <TextBlock Name="txt2" FontSize="12" FontWeight="Bold" />
    </StackPanel>   

    <StackPanel Grid.Row="2" Grid.Column="0" Grid.ColumnSpan="2" Margin="5" 
                Orientation="Horizontal">
        <Viewbox MaxWidth="100" MaxHeight="100" Name="vb1">
            <Image Source="flower.jpg"/>
        </Viewbox>
        <Viewbox MaxWidth="200" MaxHeight="200" Name="vb2">
            <Image Source="flower.jpg"/>
        </Viewbox>
        
        <Viewbox MaxWidth="300" MaxHeight="300" Name="vb3">
            <Image Source="flower.jpg"/>
        </Viewbox>
    </StackPanel>

</Grid>

Hinweise

MaxHeight ist eine von drei beschreibbaren Eigenschaften in FrameworkElement , die Höheninformationen angeben. Die beiden anderen sind Height und MinHeight. Wenn es einen Konflikt zwischen diesen Werten gibt, ist die Reihenfolge der Anwendung für die tatsächliche Höhenermittlung, dass zuerst MinHeight , dann MaxHeightund schließlich, wenn es sich innerhalb der Grenzen befindet, Height berücksichtigt werden muss. Alle diese Eigenschaften sind Empfehlungen für das Layoutverhalten des übergeordneten Elements in der Objektstruktur. Die Höhe des Objekts nach der Layoutausführung ist als ActualHeight-Eigenschaftswert verfügbar.

Die endgültige ActualHeight eines Elements kann überschreiten MaxHeight. Wenn beispielsweise UseLayoutRounding auf true festgelegt ist und Ihre App auf einem Display mit einer Auflösungsskala von mehr als 100 % ausgeführt wird, kann der ActualHeight-Wert aufgerundet werden, um sicherzustellen, dass Ihre Benutzeroberfläche beim Skalieren nicht verschwommen aussieht.

Weitere Informationen

• ActualHeight
• Height
• MinHeight
• Definieren von Layouts mit XAML