FrameworkElement.MaxHeight Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml

Obtient ou définit la contrainte de hauteur maximale d’un FrameworkElement.

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

Valeur de propriété

Double

double

Hauteur maximale de l’objet, en pixels. La valeur par défaut est PositiveInfinity. Cette valeur peut être n’importe quelle valeur égale ou supérieure à 0. PositiveInfinity est également valide.

Exemples

Cet exemple XAML montre une technique consistant à spécifier un MaxHeight pour un ViewBox. ViewBox est un élément décoratif qui peut appliquer des informations de disposition à un seul enfant et diviser les zones de disposition pour l’élément parent suivant (dans ce cas , un StackPanel).

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

Remarques

MaxHeight est l’une des trois propriétés accessibles en écriture sur FrameworkElement qui spécifient des informations de hauteur. Les deux autres sont Height et MinHeight. En cas de conflit entre ces valeurs, l’ordre d’application pour la détermination de la hauteur réelle est que minHeight doit d’abord être respecté, puis MaxHeight, et enfin, s’il est dans des limites, Height. Toutes ces propriétés sont des recommandations pour le comportement de disposition du parent de l’élément dans l’arborescence d’objets. La hauteur de l’objet après l’exécution de la disposition est disponible en tant que valeur de propriété ActualHeight .

La valeur ActualHeight finale d’un élément peut dépasser MaxHeight. Par exemple, si UseLayoutRounding est défini sur et que votre application s’exécute sur un écran avec une échelle de résolution supérieure à true 100 %, l’élément ActualHeight peut être arrondi pour vous assurer que votre interface utilisateur ne semble pas floue lorsqu’elle est mise à l’échelle.

Voir aussi

• ActualHeight
• Height
• MinHeight
• Définir des dispositions avec XAML