ListItem.Margin ListItem.Margin ListItem.Margin ListItem.Margin Property

Definition

Ruft die Stärke des Rands des Elements ab oder legt diese festGets or sets the margin thickness for the element.

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

Eine Thickness-Struktur, die die anzuwendende Stärke des Rands in geräteunabhängigen Pixeln angibt.A Thickness structure that specifies the amount of margin to apply, in device independent pixels. Der Standardwert ist die einheitliche Stärke 0 (null), also (0,0).The default is a uniform thickness of zero (0.0).

Beispiele

Im folgenden Beispiel wird gezeigt, wie das Margin -Attribut Block eines-ElementsParagraph() festgelegt wird.The following example shows how to set the Margin attribute of a Block element (Paragraph).

<FlowDocument Background="LightSlateGray" ColumnWidth="2000">
  <Section Background="DarkMagenta" Margin="0" Padding="0">
    <Paragraph Background="White">
      <Run>Default paragraph.</Run>
    </Paragraph>
    <Paragraph Background="White">
      <Run>Default paragraph.</Run>
    </Paragraph>
    <Paragraph Background="LightBlue" Margin="50">
      <Run>This paragraph has a magin of 50 pixels set, but no padding.</Run>
    </Paragraph>
    <Paragraph Background="LightCoral" Padding="50">
      <Run>This paragraph has padding of 50 pixels set, but no margin.</Run>
    </Paragraph>
    <Paragraph Background="LightGreen" Margin="50" Padding="50">
      <Run>This paragraph has both padding and margin set to 50 pixels.</Run>
    </Paragraph>
    <Paragraph Background="White">
      <Run>Default paragraph.</Run>
    </Paragraph>
    <Paragraph Background="White">
      <Run>Default paragraph.</Run>
    </Paragraph>
  </Section>
</FlowDocument>

Die folgende Abbildung zeigt, wie dieses Beispiel gerendert wird.The following figure shows how this example renders. Zur Veranschaulichung werden übertriebene stärken und Farben verwendet.Exaggerated thicknesses and colors are used for illustration.

![Verschaffen Absätze mit Bildschirm Abbildung und Seiten]Ränder(~/add/media/block-marginpadding.png ": Absätze mit Auffüllung und Rändern")Screenshot: Paragraphs with padding and margins

Im folgenden Beispiel wird gezeigt, wie die Margin -Eigenschaft Programm gesteuert festgelegt wird.The following example shows how to set the Margin property programmatically.

FlowDocument flowDoc = new FlowDocument();
Section sec = new Section();

flowDoc.Background = Brushes.LightSlateGray;
flowDoc.ColumnWidth = 2000;
sec.Background = Brushes.DarkMagenta;
sec.Padding = sec.Margin = new Thickness(0);

Paragraph defPar1 = new Paragraph(new Run("Default paragraph."));
Paragraph defPar2 = new Paragraph(new Run("Default paragraph."));
Paragraph defPar3 = new Paragraph(new Run("Default paragraph."));
Paragraph defPar4 = new Paragraph(new Run("Default paragraph."));
defPar1.Background = defPar2.Background = defPar3.Background = defPar4.Background = Brushes.White;

Paragraph marginPar = new Paragraph(new Run("This paragraph has a magin of 50 pixels set, but no padding."));
marginPar.Background = Brushes.LightBlue;
marginPar.Margin = new Thickness(50);
Paragraph paddingPar = new Paragraph(new Run("This paragraph has padding of 50 pixels set, but no margin."));
paddingPar.Background = Brushes.LightCoral;
paddingPar.Padding = new Thickness(50);
Paragraph marginPaddingPar = new Paragraph(new Run("This paragraph has both padding and margin set to 50 pixels."));
marginPaddingPar.Background = Brushes.LightGreen;
marginPaddingPar.Padding = marginPaddingPar.Margin = new Thickness(50);

sec.Blocks.Add(defPar1);
sec.Blocks.Add(defPar2);
sec.Blocks.Add(marginPar);
sec.Blocks.Add(paddingPar);
sec.Blocks.Add(marginPaddingPar);
sec.Blocks.Add(defPar3);
sec.Blocks.Add(defPar4);
flowDoc.Blocks.Add(sec);
Dim flowDoc As New FlowDocument()
Dim sec As New Section()

flowDoc.Background = Brushes.LightSlateGray
flowDoc.ColumnWidth = 2000
sec.Background = Brushes.DarkMagenta
sec.Margin = New Thickness(0)
sec.Padding = sec.Margin

Dim defPar1 As New Paragraph(New Run("Default paragraph."))
Dim defPar2 As New Paragraph(New Run("Default paragraph."))
Dim defPar3 As New Paragraph(New Run("Default paragraph."))
Dim defPar4 As New Paragraph(New Run("Default paragraph."))
defPar4.Background = Brushes.White
defPar3.Background = defPar4.Background
defPar2.Background = defPar3.Background
defPar1.Background = defPar2.Background

Dim marginPar As New Paragraph(New Run("This paragraph has a magin of 50 pixels set, but no padding."))
marginPar.Background = Brushes.LightBlue
marginPar.Margin = New Thickness(50)
Dim paddingPar As New Paragraph(New Run("This paragraph has padding of 50 pixels set, but no margin."))
paddingPar.Background = Brushes.LightCoral
paddingPar.Padding = New Thickness(50)
Dim marginPaddingPar As New Paragraph(New Run("This paragraph has both padding and margin set to 50 pixels."))
         With marginPaddingPar
             .Background = Brushes.LightGreen
             .Margin = New Thickness(50)
             .Padding = marginPaddingPar.Margin
         End With

         sec.Blocks.Add(defPar1)
         sec.Blocks.Add(defPar2)
         sec.Blocks.Add(marginPar)
         sec.Blocks.Add(paddingPar)
         sec.Blocks.Add(marginPaddingPar)
         sec.Blocks.Add(defPar3)
         sec.Blocks.Add(defPar4)
         flowDoc.Blocks.Add(sec)

Hinweise

Marginder Puffer Raum, der außerhalb des Inhalts Bereichs eines Elements liegt, zwischen den Rändern des Inhalts Bereichs des Elements und den Rändern des übergeordneten Elements.Margin is buffer space that falls outside an element's content area, between the edges of the element's content area and the edges of the parent element. Steht im PaddingGegensatz zu, bei dem es sich um einen Pufferbereich handelt, der im Inhalts Bereich eines Elements liegt, zwischen dem Inhalt des Elements und dem inneren Rand des Elements.Contrast with Padding, which is buffer space that falls inside an element's content area, between the element's content and the inner edge of the element.

Verwendung von XAML-AttributenXAML Attribute Usage

<object Margin="uniformThickness"/>  
- or -  
<object Margin="independentThickness"/>  
- or -  
<object Margin="qualifiedUniformThickness"/>  
- or -  
<object Margin="qualifiedIndependentThickness"/>  

XAML-WerteXAML Values

uniformThicknessuniformThickness
Zeichen folgen Darstellung eines einzelnen Double Werts, der einheitlich auf alle vier Größen Dimensionen angewendet werden soll.String representation of a single Double value to apply uniformly to all four thickness dimensions. Beispielsweise entspricht der "10" Wert einem Wert von. "10,10,10,10"For example, a value of "10" is equivalent to a value of "10,10,10,10". Ein nicht qualifizierter Wert wird in geräteunabhängigen Pixeln gemessen.An unqualified value is measured in device independent pixels. Zeichen folgen müssen nicht explizit Dezimalstellen enthalten.Strings need not explicitly include decimal points.

independentThicknessindependentThickness
Zeichen folgen Darstellung von vier Double geordneten Werten, die den unabhängigen Größen der Dicke für Links, oben, rechts und unten in dieser Reihenfolge entsprechen.String representation of four ordered Double values corresponding to independent thickness dimensions for left, top, right, and bottom, in this order. Die vier Werte müssen durch Kommas getrennt werden. Leerzeichen sind nicht zulässig.The four values must be separated with commas; spaces are not allowed. Beispiel: "5, 10, 15, 20" ergibt 5 Pixel Rand links neben dem Inhalt, 10 Pixel Rand oberhalb des Inhalts, 15 Pixel Rand rechts neben dem Inhalt und 20 Pixel Rand unterhalb des Inhalts.For example, "5,10,15,20" results in 5 pixels of margin to the left of content, 10 pixels of margin above content, 15 pixels of margin to the right of content, and 20 pixels of margin below the content.

qualifiedUniformThicknessqualifiedUniformThickness
Ein durch unifordicke beschriebener Wert, gefolgt von einem der folgenden Einheits spezifiken px: in,.A value described by uniformThickness followed by one of the following unit specifiers: px, in.

px(Standard) istGeräteunabhängige Einheiten (1/96 Zoll pro Einheit)device-independent units (1/96th inch per unit)px (default) is Geräteunabhängige Einheiten (1/96 Zoll pro Einheit)device-independent units (1/96th inch per unit)

inist Zoll; 1In = = 96pxin is inches; 1in==96px

Beispielsweise "1in" bietet einen einheitlichen Rand von 1 Zoll in alle Richtungen.For example, "1in" provides uniform margin of 1 inch in all directions.

qualifiedIndependentThicknessqualifiedIndependentThickness
Ein durch independentdickebeschriebener Wert, mit jedem unabhängigen Wert, gefolgt von einem der folgenden Einheits Spezifizierer in: px,.A value described by independentThickness, with each independent value followed by one of the following unit specifiers: px, in.

px(Standard) istGeräteunabhängige Einheiten (1/96 Zoll pro Einheit)device-independent units (1/96th inch per unit)px (default) is Geräteunabhängige Einheiten (1/96 Zoll pro Einheit)device-independent units (1/96th inch per unit)

inist Zoll; 1In = = 96pxin is inches; 1in==96px

Beispielsweise "1.5in,0.8in,1.5in,0.8in".For example, "1.5in,0.8in,1.5in,0.8in". Einheitenspezifizierer können aus einem oder mehreren Werten gemischt oder ausgelassen werden.Unit specifiers may be mixed or omitted from one or more values.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field MarginProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true AffectsMeasure

Gilt für:

Siehe auch