FrameworkElement.MaxHeight Eigenschaft

Referenz

Definition

Namespace:: Windows.UI.Xaml

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Ruft die maximale Höheeinschränkung eines FrameworkElements 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 gleich oder größer 0 sein. PositiveInfinity ist ebenfalls gültig.

Beispiele

Dieses XAML-Beispiel zeigt eine Technik zum Angeben eines MaxHeight-Steuerelements 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) unterteilen 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 anderen beiden sind Height und MinHeight. Wenn es einen Konflikt zwischen diesen Werten gibt, lautet die Reihenfolge der Anwendung für die tatsächliche Höhenbestimmung, dass zuerst MinHeight , dann MaxHeight und schließlich, wenn es innerhalb der Grenzen liegt, 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 MaxHeight überschreiten. Wenn Beispielsweise UseLayoutRounding auf true festgelegt ist und Ihre App auf einem Bildschirm mit einer Auflösungsskala von mehr als 100 % ausgeführt wird, kann ActualHeight aufgerundet werden, um sicherzustellen, dass Ihre Benutzeroberfläche beim Skalieren nicht verschwommen aussieht.

Gilt für: