FrameworkElement.Margin Propriété

Définition

Obtient ou définit la marge extérieure d’un élément.

public:
 property System::Windows::Thickness Margin { System::Windows::Thickness get(); void set(System::Windows::Thickness value); };
public System.Windows.Thickness Margin { get; set; }
member this.Margin : System.Windows.Thickness with get, set
Public Property Margin As Thickness

Valeur de propriété

Fournit des valeurs de marge pour l’élément. La valeur par défaut est Thickness avec toutes les propriétés égales à 0 (zéro).

Remarques

La marge est l’espace entre cet élément et d’autres éléments qui seront adjacents lorsque la disposition créera l’interface utilisateur. Les éléments partagés peuvent être des éléments homologues (tels que d’autres éléments dans la collection d’un contrôle parent commun) ou peuvent également être le parent de cet élément.

Margin est défini comme une Thickness structure plutôt que comme un nombre afin que la marge puisse être définie de manière asymétrique. La Thickness structure elle-même prend en charge la conversion de type chaîne afin que vous puissiez également spécifier une syntaxe asymétrique Margin dans l’attribut XAML.

Une marge non nulle applique l’espace en dehors de la disposition de l’élément ActualWidth et ActualHeight.

Les marges sont additives pour les éléments frères dans une disposition ; par exemple, deux éléments adjacents avec une marge de 30 définie sur le bord adjacent auraient 60 unités d’espace entre eux.

Les éléments qui ont des marges définies ne limitent généralement pas la taille du spécifié Margin si l’espace rectangle alloué n’est pas assez grand pour la marge plus la zone de contenu de l’élément. La zone de contenu de l’élément est contrainte lorsque la disposition est calculée. Le seul cas où les marges seraient également limitées est si le contenu est déjà limité à zéro.

Utilisation d'attributs XAML

<object Margin="left,top,right,bottom"/>  

- ou -

<object Margin="left,top"/>  

- ou -

<object Margin="thicknessReference"/>  

Utilisation des éléments de propriété XAML

<object>  
  <object.Margin>  
    <Thickness Left="left" Top="top" Right="right" Bottom="bottom"/>  
  </object.Margin>  
</object>  

Valeurs XAML

gauche, haut, droite, bas
Valeurs de nombre comprises entre 0 et PositiveInfinity qui spécifient les quatre propriétés de dimension possibles d’une Thickness structure.

L’utilisation de l’attribut accepte également les valeurs abrégées qui s’appliquent dans l’ordre fourni, symétriquement et logiquement. Par instance, Margin="20" est interprété comme signifiant un Thickness avec toutes les propriétés définies sur 20. Margin="20,50" est interprété comme signifiant un Thickness avec Left et Right défini sur 20, et Top sur Bottom 50.

L’unité par défaut d’une Thickness mesure est l’unité indépendante de l’appareil (1/96e pouce). Vous pouvez également spécifier d’autres unités en ajoutant les chaînes cmde type d’unité , inou pt à n’importe quelle mesure.

Les valeurs de nombre fournies en tant qu’attributs XAML n’ont pas besoin de spécifier de décimales (0 est acceptable, il n’est pas nécessaire d’indiquer 0,0). Pour plus d’informations sur l’utilisation du langage XAML (Extensible Application Markup Language), consultez Thickness.

epaisseurReference
Référence d’objet à un objet existant Thickness. Il peut s’agir d’une }référence , ou } d’une référence. Pour plus d’informations sur l’utilisation du langage XAML (Extensible Application Markup Language), consultez Thickness.

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

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

S’applique à

Voir aussi