FrameworkElement.Width Propriété

Définition

Obtient ou définit la largeur de l'élément.

public:
 property double Width { double get(); void set(double value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public double Width { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Width : double with get, set
Public Property Width As Double

Valeur de propriété

Largeur de l’élément, en unités indépendantes de l’appareil (1/96e pouce par unité). La valeur par défaut est NaN. Cette valeur doit être supérieure ou égale à 0.0. Consultez la section Notes pour plus d’informations sur la limite supérieure.

Attributs

Remarques

Il s’agit de l’une des trois propriétés sur qui spécifient des informations de FrameworkElement largeur. Les deux autres sont MinWidth et MaxWidth. En cas de conflit entre ces valeurs, l’ordre d’application pour la détermination de la largeur réelle doit d’abord MinWidth être respecté, puis MaxWidth, et enfin si chacune d’elles se trouve dans des limites, Width.

La valeur de retour de cette propriété est toujours la même que toute valeur qui lui a été définie. En revanche, la valeur de peut ActualWidth varier. La disposition a peut-être rejeté la taille suggérée pour une raison quelconque. En outre, le système de disposition lui-même fonctionne de manière asynchrone par rapport au jeu de systèmes de propriétés de Width et n’a peut-être pas encore traité cette modification de propriété de dimensionnement particulière.

En plus des valeurs acceptables Double , cette propriété peut également être Double.NaN. C’est ainsi que vous spécifiez le comportement de dimensionnement automatique. En XAML, vous définissez la valeur sur la chaîne « Auto » (qui ne respecte pas la casse) pour activer le comportement de dimensionnement automatique. Le comportement de dimensionnement automatique implique que l’élément remplira la largeur disponible. Notez toutefois que des contrôles spécifiques fournissent fréquemment des valeurs par défaut dans leurs styles par défaut, ce qui désactive le comportement de dimensionnement automatique, sauf s’il est spécifiquement réactivé.

En plus de la validation case activée, il existe une valeur supérieure non déterministe liée à Width qui est appliquée par le système de disposition (il s’agit d’un nombre très important, supérieur Single.MaxValue à mais inférieur à Double.MaxValue). Si vous dépassez cette limite, l’élément ne s’affiche pas et aucune exception n’est levée. Ne définissez Width pas sur une valeur qui est considérablement supérieure à la taille maximale d’un affichage visuel possible, ou vous pouvez dépasser cette limite supérieure non déterministe.

Utilisation d'attributs XAML

<object Width="double"/>  

- ou -

<object Width ="qualifiedDouble"/>  

- ou -

<object Width ="Auto"/>  

Valeurs XAML

double
Double

Représentation sous forme de chaîne d’une Double valeur égale ou supérieure à 0,0. Consultez la section Notes pour plus d’informations sur la limite supérieure. Cette valeur est interprétée comme une mesure d’unité indépendante de l’appareil (1/96e pouce). Les chaînes n’ont pas besoin d’inclure explicitement des décimales. Par instance une valeur de 1 est acceptable.

qualifiedDouble
Valeur double comme décrit ci-dessus, suivie de l’une des chaînes de déclaration d’unité suivantes : px, in, cm, pt.

px (valeur par défaut) est des unités indépendantes de l’appareil (1/96e pouce par unité)

in est en pouces ; 1in==96px

cm est centimètres; 1cm==(96/2.54) px

pt est des points ; 1pt==(96/72) px

Auto
Active le comportement de redimensionnement automatique. Consultez la section Notes.

Informations sur les propriétés de dépendance

Champ Identificateur WidthProperty
Propriétés de métadonnées définies sur true AffectsMeasure

S’applique à