ColumnDefinition.Width Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Obtient la largeur calculée d’un élément ColumnDefinition ou définit la valeur GridLength d’une colonne définie par columnDefinition. Il s’agit de la propriété content de ColumnDefinition.

public:
 property GridLength Width { GridLength get(); void set(GridLength value); };

GridLength Width();

void Width(GridLength value);

public GridLength Width { get; set; }

var gridLength = columnDefinition.width;
columnDefinition.width = gridLength;

Public Property Width As GridLength

<ColumnDefinition Width="doubleValue"/>
- or -
<ColumnDefinition Width="starSizing"/>
-or-
<ColumnDefinition Width="Auto"/>

Valeur de propriété

GridLength

GridLength qui représente la largeur de la colonne. La valeur par défaut est un GridLength représentant un dimensionnement « 1* ».

Remarques

La valeur par défaut de Width est un GridLength représentant un dimensionnement « 1* ». Cette valeur de structure a une valeur de données Value de 1.0 et une valeur de données GridUnitType de Star. Avec cette valeur par défaut, chaque nouvelle ColumnDefinition que vous définissez pour une grille aura un dimensionnement « 1* », et chaque élément recevra un nombre égal de pixels pour la largeur de son contenu dans la gestion de la disposition. Il n’est pas rare de définir ColumnDefinition en tant qu’élément objet en XAML sans attributs définis et d’utiliser simplement ce comportement par défaut. Il en va de même pour RowDefinition.

La valeur que vous définissez pour Width peut être limitée si vous définissez également une valeur pour MinWidth ou MaxWidth. Chacune de ces propriétés ne peut prendre que des mesures de pixels, pas de dimensionnement en étoile . Si un ColumnDefinition utilise le dimensionnement Star ou Auto , mais a également des contraintes MinWidth ou MaxWidth , le MinWidth ou MaxWidth doit être respecté par le comportement de disposition Grid , même si cela signifie donner ou prendre de l’espace de disposition à partir d’autres colonnes de dimensionnement Star définies dans la grille qui n’ont pas de contraintes.

Il est plus courant d’utiliser le dimensionnement en étoile que les valeurs de pixel absolues pour une définition grid dans une application UWP en C++, C# ou Visual Basic. Le dimensionnement en étoile prend en charge le concept de disposition dynamique, ce qui permet à votre application d’avoir une belle apparence sur les écrans avec des tailles, des densités de pixels et des orientations différentes. Pour plus d’informations, consultez Définir des dispositions avec XAML.

Voir aussi

• Grid
• ColumnDefinitions
• Column
• Définir des dispositions avec XAML