AnchoredBlock.Padding Eigenschaft

Definition

Namespace:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Ruft die Abstandsstärke für das Element ab oder legt diese fest.

public:
 property System::Windows::Thickness Padding { System::Windows::Thickness get(); void set(System::Windows::Thickness value); };

public System.Windows.Thickness Padding { get; set; }

member this.Padding : System.Windows.Thickness with get, set

Public Property Padding As Thickness

Eigenschaftswert

Thickness

Eine Thickness-Struktur, die den anzuwendenden Abstand in geräteunabhängigen Pixeln angibt.

Der Standardwert ist die einheitliche Stärke 0 (null) (0,0).

Beispiele

Das folgende Beispiel zeigt, wie das Padding Attribut eines Block Elements (Paragraph) festgelegt wird.

<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. Zur Veranschaulichung werden überhöhte Stärken und Farben verwendet.

Das folgende Beispiel zeigt, wie Sie die Padding-Eigenschaft programmatisch einstellen können.

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

Padding ist ein Pufferraum, der innerhalb des Inhaltsbereichs eines Elements zwischen dem Inhalt des Elements und dem inneren Rand des Elements liegt. Kontrast mit Margin, wobei es sich um Pufferraum handelt, der außerhalb des Inhaltsbereichs eines Elements zwischen den Rändern des Inhaltsbereichs des Elements und den Kanten des übergeordneten Elements liegt.

Verwendung von XAML-Attributen

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

XAML-Werte

UniformBeschnackung
Zeichenfolgendarstellung eines einzelnen Double Werts, der einheitlich auf alle vier Dickendimensionen angewendet werden soll. Ein Wert von "10" entspricht beispielsweise einem Wert von "10,10,10,10". Ein nicht qualifizierter Wert wird in geräteunabhängigen Pixeln gemessen. Zeichenfolgen müssen nicht explizit Dezimalpunkte enthalten.

independentThickness
Zeichenfolgendarstellung von vier geordneten Double Werten, die unabhängigen Dickendimensionen für links, oben, rechts und unten entsprechen, in dieser Reihenfolge. Die vier Werte müssen durch Kommas getrennt werden. Leerzeichen sind nicht zulässig. Beispielsweise führt "5,10,15,20" zu 5 Pixeln Auffüllung links vom Inhalt, 10 Pixel Füllung oberhalb des Inhalts, 15 Pixel Füllung rechts neben Dem Inhalt und 20 Pixel Füllung unterhalb des Inhalts.

qualifiedUniformThickness
Ein Wert, der durch uniformThickness gefolgt von einem der folgenden Einheitenspezifizierer beschrieben wird: px, in.

px (Standard) ist geräteunabhängige Einheiten (1/96 Zoll pro Einheit)

in ist Zoll; 1in==96px

"1in" Beispielsweise bietet eine gleichmäßige Füllung von 1 Zoll in alle Richtungen.

qualifiedIndependentThickness
Ein von independentThickness beschriebener Wert mit jedem unabhängigen Wert gefolgt von einem der folgenden Einheitenspezifizierer: px, in.

px (Standard) ist geräteunabhängige Einheiten (1/96 Zoll pro Einheit)

in ist Zoll; 1in==96px

Beispiel: "1.5in,0.8in,1.5in,0.8in". Einheitenspezifizierer können gemischt oder aus einem oder mehreren Werten weggelassen werden.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	PaddingProperty
Metadateneigenschaften auf true festgelegt	AffectsMeasure