(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

FrameworkElement.Margin-Eigenschaft

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

Namespace:  System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)
XMLNS für XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public Thickness Margin { get; set; }
<object>
  <object.Margin>
    <Thickness Left="left" Top="top" Right="right" Bottom="bottom"/>
  </object.Margin>
</object>

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

XAML-Werte

links, oben, erchte, unten

Zahlenwerte zwischen 0 und PositiveInfinity, die die vier möglichen Dimensionseigenschaften einer Thickness-Struktur angeben.

Für die Attributverwendung sind auch abgekürzte Werte zulässig, die symmetrisch und logisch in der angegebenen Reihenfolge übernommen werden. Margin="20" wird interpretiert, um einen Thickness zu mitteln, wobei alle Eigenschaften auf 20 festgelegt werden. Margin="20,50" wird interpretiert, um einen Thickness mit Left-Wert und Right-Wert, der auf 20 festgelegt wurde, und einen Top-Wert und Bottom-Wert, der auf 50 festgelegt wurde, zu mitteln.

Die Standardeinheit für ein Thickness-Maß ist geräteunabhängige Einheit (1/96 Zoll). Sie können auch andere Einheiten angeben, indem Sie die Zeichenfolgen cm, in oder pt für den Einheitentyp an alle Werte anfügen.

Bei als XAML-Attribute angegebenen Zahlenwerten muss kein Dezimalkomma angegeben werden (0 ist zulässig und muss nicht als 0,0 eingegeben werden). Weitere Informationen über die Extensible Application Markup Language (XAML)-Verwendung finden Sie unter Thickness.

thicknessReference

Ein Objektverweis auf eine vorhandene Thickness. Hierbei kann es sich um folgende Verweise handeln: {Binding}}, {StaticResource} oder {DynamicResource}}. Weitere Informationen über die Extensible Application Markup Language (XAML)-Verwendung finden Sie unter Thickness.

Eigenschaftswert

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

Bezeichnerfeld

MarginProperty

Auf true festgelegte Metadateneigenschaften

AffectsMeasure

Der Rand ist der Raum zwischen diesem Element und anderen, nach dem Erstellen der Benutzeroberfläche (user interface, UI) durch das Layout angrenzenden Elementen. Gemeinsam genutzte Elemente können Peerelemente (z. B. andere Elemente in der Auflistung eines gemeinsamen übergeordneten Steuerelements) oder auch das übergeordnete Element dieses Elements sein.

Margin ist nicht als Zahl, sondern als Thickness-Struktur festgelegt, damit der Rand asymmetrisch festgelegt werden kann. Die Thickness-Struktur unterstützt die Konvertierung des Zeichenfolgentyps. Daher können Sie auch in Attributsyntax einen asymmetrischen Margin in XAML angeben.

Wenn der Wert für den Rand ungleich 0 (null) ist, wird der entsprechende Abstand außerhalb der ActualWidth und ActualHeight des Elementlayouts hinzugefügt.

Ränder sind bei gleichgeordneten Elementen in einem Layout additiv. Beispielsweise liegen zwischen zwei aneinandergrenzenden Elementen mit einem Rand von je 30 Einheiten demnach 60 Einheiten.

Elemente mit festgelegten Rändern beschränken die Größe des angegebenen Margin i. d. R. nicht, wenn der zugewiesene Raum für das Rechteck für den Rand und den Inhaltsbereich des Elements nicht breit genug ist. Beim Berechnen des Layouts wird der Inhaltsbereich des Elements jedoch beschränkt. Der einzige Fall, in dem auch die Ränder beschränkt werden, liegt vor, wenn der Inhalt bereits auf 0 (null) beschränkt ist.

In diesem Beispiel wird beschrieben, wie die Margin-Eigenschaft festgelegt wird, indem vorhandene Eigenschaftswerte für einen Rand im Code-Behind geändert wird. Die Margin-Eigenschaft ist eine Eigenschaft des FrameworkElement-Basiselements und wird deshalb von einer Vielzahl von Steuerelementen und anderen Elementen geerbt.

Dieses Beispiel ist in Extensible Application Markup Language (XAML) geschrieben und verfügt über eine Code-Behind-Datei, auf die XAML verweist. Die Code-Behind-Datei wird sowohl in einer C#-Version als auch in einer Microsoft Visual Basic-Version angezeigt.


<Button Click="OnClick" Margin="10" Name="btn1">
Click To See Change!!</Button>



Private Sub OnClick(ByVal sender As Object, ByVal e As RoutedEventArgs)

    ' Get the current value of the property.
    Dim marginThickness As Thickness
    marginThickness = btn1.Margin
    ' If the current leftlength value of margin is set to 10 then change it to a new value.
    ' Otherwise change it back to 10.
    If marginThickness.Left = 10 Then
        btn1.Margin = New Thickness(60)
    Else
        btn1.Margin = New Thickness(10)
    End If
End Sub



void OnClick(object sender, RoutedEventArgs e)
{
    // Get the current value of the property.
    Thickness marginThickness = btn1.Margin;
    // If the current leftlength value of margin is set to 10 then change it to a new value.
    // Otherwise change it back to 10.
    if(marginThickness.Left == 10)
    {
         btn1.Margin = new Thickness(60);
    } else {
         btn1.Margin = new Thickness(10);
    }
}


.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft