Lire en anglais

Partager via


FrameworkElement.MaxWidth Propriété

Définition

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

public double MaxWidth { get; set; }
<frameworkElement MaxWidth="double"/>
 

Valeur de propriété

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.

S’applique à

Produit Versions
WinRT Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100

Voir aussi