FrameworkElement.Margin Propriété

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 une Thickness valeur dont toutes les propriétés sont é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ée l’interface utilisateur (UI). 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 de chaîne afin que vous puissiez spécifier une syntaxe d’attribut XAML asymétrique Margin également.

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

Les marges sont additifs pour les éléments frères d’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 un jeu de marges ne limitent généralement pas la taille du rectangle spécifié Margin si l’espace rectangle alloué n’est pas suffisamment grand pour la marge plus la zone de contenu de l’élément. La zone de contenu de l’élément est limitée à la place lorsque la disposition est calculée. Le seul cas où les marges seraient contraintes est également si le contenu est déjà limité jusqu’à zéro.

Utilisation des attributs XAML

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

- ou -

<object Margin="left,top"/>

- ou -

<object Margin="thicknessReference"/>

Utilisation de l’élément de propriété XAML

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

Valeurs XAML

gauche, haut, droit, bas Valeurs numériques 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 exemple, Margin="20" sera interprété pour signifier une Thickness valeur de toutes les propriétés définies sur 20. Margin="20,50"sera interprété pour signifier un Thickness avec Left et Right défini sur 20, et TopBottom défini sur 50.

L’unité par défaut d’une Thickness mesure est une 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 numériques fournies en tant qu’attributs XAML n’ont pas besoin de spécifier de décimales (0 est acceptable, ne doivent pas nécessairement être fournies comme 0,0). Pour plus d’informations sur l’utilisation du langage XAML (Extensible Application Markup Language), consultez Thickness.

thicknessReference Référence d’objet à un objet existant Thickness. Il peut s’agir d’un , d’un 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

Voir aussi

• Thickness