FrameworkElement.MaxWidth Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml

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

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

double MaxWidth();

void MaxWidth(double value);

public double MaxWidth { get; set; }

var double = frameworkElement.maxWidth;
frameworkElement.maxWidth = double;

Public Property MaxWidth As Double

<frameworkElement MaxWidth="double"/>
 

Valeur de propriété

Double

double

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

MaxWidth est l’une des trois propriétés accessibles en écriture sur FrameworkElement qui spécifient des informations de largeur. Les deux autres sont MinWidth et Width. En cas de conflit entre ces valeurs, l’ordre d’application pour la détermination de la largeur réelle est que minWidth doit d’abord être respecté, puis MaxWidth, et enfin, s’il se trouve dans des limites, Width. 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 largeur de l’objet après l’exécution de la disposition est disponible en tant que valeur de propriété ActualWidth .

La valeur ActualWidth finale d’un élément peut dépasser MaxWidth. 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 %, actualWidth peut être arrondi vers le haut pour vous assurer que votre interface utilisateur ne semble pas floue lorsqu’elle est mise à l’échelle.

Voir aussi

• Width
• MinWidth
• Définir des dispositions avec XAML