FrameworkElement.MaxWidth Propriété

Définition

Espace de noms:

Windows.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 de spécification d’un MaxWidth pour une ViewBox. ViewBox est un décorateur 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. S’il existe un 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 .

L’ActualWidth final d’un élément peut dépasser MaxWidth. Par exemple, si UseLayoutRounding a la valeur true et que votre application s’exécute sur un écran avec une échelle de résolution supérieure à 100 %, l’élément ActualWidth peut être arrondi pour garantir que votre interface utilisateur ne semble pas floue lors de la mise à l’échelle.

Voir aussi

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