FrameworkElement.MaxWidth Propriété
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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"/>
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.
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>
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.
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 |