FrameworkElement.Margin Eigenschaft

Definition

Dient zum Abrufen oder Festlegen des äußeren Rands eines Elements.

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 mit allen Eigenschaften gleich 0 (Null).

Hinweise

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

Margin wird als Struktur und nicht als Thickness 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 Nicht-Null-Rand wendet Platz außerhalb des Elementlayouts ActualWidth und ActualHeight.

Ränder sind für gleichgeordnete Elemente in einem Layout additiv; Beispielsweise hätten zwei benachbarte Elemente, die beide mit einem Rand von 30 auf dem angrenzenden Rand festgelegt sind, 60 Einheiten Platz dazwischen.

Elemente mit festgelegten Seitenrändern beschränken in der Regel nicht die Größe des angegebenen Margin Bereichs, wenn der zugewiesene Rechteckraum für den Rand und den Elementinhaltsbereich nicht groß genug ist. Der Elementinhaltsbereich wird stattdessen beim Berechnen des Layouts eingeschränkt. Der einzige Fall, bei dem Ränder eingeschränkt würden, ist auch, wenn der Inhalt bereits auf Null beschrä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 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. Wird beispielsweise so interpretiert, Margin="20" dass eine Thickness mit allen Eigenschaften auf 20 festgelegt ist. Margin="20,50"wird so interpretiert, ThicknessLeft dass es sich um ein Right "With" Top und Bottom "20" und "50" bezieht.

Die Standardeinheit für ein Thickness Maß ist geräteunabhängig (1/96. Zoll). Sie können auch andere Einheiten angeben, indem Sie die Einheitentypzeichenfolgen , , cmoder in an ein beliebiges ptMaß anfügen.

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

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

Informationen zur Abhängigkeitseigenschaft

Element Wert
Bezeichnerfeld MarginProperty
Auf Metadateneigenschaften festgelegt true AffectsMeasure

Gilt für:

Weitere Informationen