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 égale ou supérieure à 0,0. Consultez les remarques pour obtenir des informations relatives aux limites supérieures.

Attributs

Remarques

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

La valeur de retour de cette propriété est toujours identique à n’importe quelle valeur qui lui a été définie. En revanche, la valeur du fichier ActualWidth peut 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 à l’ensemble de systèmes de propriétés et Width peut ne pas avoir encore traité ce changement de propriété de dimensionnement particulier.

En plus des valeurs acceptables Double , cette propriété peut également être Double.NaN. Il s’agit de la façon dont vous spécifiez le comportement de dimensionnement automatique. En XAML, vous définissez la valeur sur la chaîne « Auto » (sans respect de 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 qui désactivent le comportement de dimensionnement automatique, sauf s’il est spécifiquement réactivé.

En plus de la vérification de validation, il existe une valeur supérieure non déterministe liée à Width celle-ci appliquée par le système de disposition (il s’agit d’un très grand nombre, supérieur mais Single.MaxValue 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 de tout affichage visuel possible, ou vous pouvez dépasser cette limite supérieure non déterministe.

Utilisation des attributs XAML

<object Width="double"/>

- ou -

<object Width ="qualifiedDouble"/>

- ou -

<object Width ="Auto"/>

Valeurs XAML

DoubleDouble

Représentation sous forme de chaîne d’une Double valeur égale ou supérieure à 0,0. Consultez les remarques pour obtenir des informations relatives aux limites supérieures. Cette valeur est interprétée comme une mesure indépendante de l’appareil (1/96e pouce). Les chaînes n’ont pas besoin d’inclure explicitement les décimales. Par exemple, une valeur est 1 acceptable.

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

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

in est pouces ; 1in==96px

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

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

Auto Active le comportement de redimensionnement automatique. Voir les remarques.

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

Élément Valeur
Champ d’identificateur WidthProperty
Propriétés de métadonnées définies sur true AffectsMeasure

S’applique à