FrameworkElement.Margin Eigenschaft

Definition

Ruft den äußeren Rand eines Elements ab oder legt ihn fest.

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

Eigenschaftswert

Stellt Randwerte für das Element bereit. Der Standardwert ist eine Thickness, bei der alle Eigenschaften gleich 0 (null) sind.

Hinweise

Der Rand ist der Abstand zwischen diesem Element und anderen Elementen, der angrenzend ist, wenn das Layout die Benutzeroberfläche (UI) erstellt. Freigegebene Elemente können Peerelemente (z. B. andere Elemente in der Auflistung eines gemeinsamen übergeordneten Steuerelements) oder auch das übergeordnete Element dieses Elements sein.

Margin wird als Thickness Struktur und nicht als Zahl festgelegt, sodass der Rand asymmetrisch festgelegt werden kann. Die Thickness Struktur selbst unterstützt die Konvertierung von Zeichenfolgentypen, sodass Sie auch eine asymmetrische Margin XAML-Attributsyntax angeben können.

Ein Rand ungleich 0 (null) wendet Platz außerhalb des Elementlayouts ActualWidth und ActualHeightan.

Ränder sind für gleichgeordnete Elemente in einem Layout additiv; Beispielsweise würden zwei angrenzende Elemente mit einem Rand von jeweils 30, die auf dem angrenzenden Rand festgelegt sind, 60 Einheiten Abstand zwischen ihnen haben.

Elemente, deren Ränder festgelegt sind, schränken die Größe des angegebenen Margin in der Regel nicht ein, wenn der zugewiesene Rechteckbereich nicht groß genug für den Rand plus den Elementinhaltsbereich ist. Der Elementinhaltsbereich wird stattdessen eingeschränkt, wenn das Layout berechnet wird. Der einzige Fall, in dem die Ränder ebenfalls eingeschränkt wären, ist, wenn der Inhalt bereits bis 0 (null) eingeschränkt ist.

Verwendung von XAML-Attributen

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

- oder -

<object Margin="left,top"/>  

- oder -

<object Margin="thicknessReference"/>  

Verwendung von XAML-Eigenschaftenelementen

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

XAML-Werte

links, oben, rechts, unten
Zahlenwerte zwischen 0 und PositiveInfinity , die die vier möglichen Dimensionseigenschaften einer Thickness Struktur angeben.

Die Attributverwendung akzeptiert auch abgekürzte Werte, die in der angegebenen Reihenfolge, symmetrisch und logisch angewendet werden. Für instance wird als ein Thickness interpretiert, Margin="20" wobei alle Eigenschaften auf 20 festgelegt sind. Margin="20,50" wird so interpretiert, dass ein Thickness mit Left und Right auf 20 Top und und auf Bottom 50 festgelegt wird.

Die Standardeinheit für ein Thickness Measure ist eine geräteunabhängige Einheit (1/96 Zoll). Sie können auch andere Einheiten angeben, indem Sie die Einheitentypzeichenfolgen , inoder pt an ein beliebiges cmMeasure anfügen.

Zahlenwerte, die als XAML-Attribute bereitgestellt werden, müssen keine Dezimalstellen angeben (0 ist akzeptabel, muss nicht als 0,0 angegeben werden). Weitere Informationen zur Verwendung von XAML (Extensible Application Markup Language) finden Sie unter Thickness.

thicknessReference
Ein Objektverweis auf eine vorhandene Thickness. Dies kann ein }- , - oder } -Verweis sein. Weitere Informationen zur Verwendung von XAML (Extensible Application Markup Language) finden Sie unter Thickness.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld MarginProperty
Metadateneigenschaften auf true festgelegt AffectsMeasure

Gilt für:

Weitere Informationen