Windows Dev Center

FrameworkElement.Width Property

Obtient ou définit la largeur d'un FrameworkElement.

Syntaxe


public double Width { get; set; }


<frameworkElement Width="double"/>
-or-
<frameworkElement Width="Auto"/>

Valeur de propriété

Type: System.Double [.NET] | float64 [C++]

Largeur de l'objet, en pixels. La valeur par défaut est NaN. À l'exception de la valeur NaN particulière, cette valeur doit être supérieure ou égale à 0.

Remarques

Width est l'une des trois propriétés accessibles en écriture de FrameworkElement qui spécifient les informations de largeur. Les deux autres sont MinWidth et MaxWidth. Si un conflit se présente entre ces valeurs, l'ordre d'application pour la détermination de la largeur réelle est le suivant : l'attribut MinWidth doit être honoré en premier, puis MaxWidth, et enfin Width, si la valeur se trouve dans les limites.

Nombre d'objets dérivés de FrameworkElement sont également dérivés de Shape. Toutes les classes Shape n'utilisent pas Height ou Width pour spécifier leur apparence, et utilisent à la place des propriétés spécifiques qui peuvent définir un ensemble de points. Dans ce cas, une valeur Height ou Width est calculée, mais elle n'est généralement pas définie directement.

Dans certains cas, les classes personnalisées peuvent avoir des propriétés qui sont plus explicites pour spécifier des dimensions que ne le sont Height ou Width. Height ou Width demeurent disponibles comme membres et sont définissables.

L'objet sur lequel la propriété Height ou Width est définie est presque toujours un objet enfant de la collection enfant d'un autre parent, et la valeur définie pour Height ou Width n'est qu'une valeur suggérée pour le processus de disposition. Le système de disposition et la logique de disposition particulière de la classe du parent utilisent la valeur comme entrée sans liaison pendant le processus de disposition et devront peut-être découper l'objet, le redimensionner, redimensionner le conteneur, ou toute autre combinaison de ces comportements qui couvre plusieurs objets participants à la disposition.

La valeur de retour de cette propriété est toujours la même que toute autre qui lui est affectée. En revanche, la valeur de la propriété ActualWidth peut varier. La variance peut se produire statiquement, car la disposition a rejeté la taille suggérée, ou momentanément. Le système de disposition proprement dit fonctionne de façon asynchrone par rapport à l'ensemble Width du système de propriétés et peut n'avoir pas encore traité cette modification de propriété de dimensionnement.

Les valeurs négatives ne sont pas autorisées pour Width. En outre, n'attribuez pas à Width une valeur sensiblement supérieure à la taille maximale de tout affichage visuel possible.

Disposition « automatique » et Double.NaN

La valeur par défaut de Height et Width n'est pas 0 mais Double.NaN. Height et Width prennent en charge la capacité à être une valeur « Auto » non définie. Étant donné que Height et Width sont des valeurs Double, Double.NaN est utilisé comme valeur spéciale pour représenter ce comportement « Automatique ». Le système de disposition interprète la valeur « Auto » pour signifier en général que l'objet doit être dimensionné selon la taille disponible dans la disposition, plutôt que d'après une valeur en pixels spécifique. Si vous souhaitez appliquer le comportement « Automatique » pour un objet lorsqu'il est utilisé dans la disposition, ne définissez pas les valeurs Height et Width (conservez leur valeur Double.NaN par défaut). Si vous avez précédemment défini des valeurs et que vous souhaitez réactiver le comportement « automatique » avec le code d'exécution, affectez à la hauteur et à la largeur la valeur Double.NaN. Dans les modèles d'état visuels, vous pouvez également définir explicitement les attributs Height et Width en XAML comme la chaîne "Auto" au lieu d'une valeur Double.

Exemples

Cet exemple montre un jeu de propriétés simple d'élément d'interface utilisateur qui est créé au moment de l'exécution et qui a besoin que ses propriétés d'affichage de contenu et de base soient initialisées, par exemple Height, Width et Background.


Button button2 = new Button();
button2.Height = 50;
button2.Width = 100;
button2.Background = new SolidColorBrush(Colors.Blue);
button2.Content = "Click Me";


Configuration requise

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Espace de noms

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Métadonnées

Windows.winmd

Voir aussi

FrameworkElement
ActualWidth
Height
Démarrage rapide : définition des dispositions

 

 

Afficher:
© 2015 Microsoft