Freigeben über


TextBlock.Padding Eigenschaft

Definition

Dient zum Abrufen oder Festlegen eines Werts, der die Stärke des Abstands zwischen den Begrenzungen des Inhaltsbereichs und dem Inhalt angibt, der von einem TextBlock.

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

Eine Thickness Struktur, die den anzuwendenden Abstand in unabhängigen Pixeln des Geräts angibt. Der Standardwert lautet NaN.

Beispiele

Das folgende Beispiel zeigt, wie das Padding Attribut eines TextBlock Elements festgelegt wird.

<TextBlock 
  Name="textBlock"
  
  Background="AntiqueWhite" 
  Foreground="Navy" 
  
  FontFamily="Century Gothic"
  FontSize="12"
  FontStretch="UltraExpanded"
  FontStyle="Italic"
  FontWeight="UltraBold"
  
  LineHeight="Auto"
  Padding="5,10,5,10"
  TextAlignment="Center"
  TextWrapping="Wrap"
  
  Typography.NumeralStyle="OldStyle"
  Typography.SlashedZero="True"
>
  <Run Background="LightGreen">Text run 1.</Run>
  <LineBreak/><Run Background="LightBlue">Text run 2.</Run>
  <LineBreak/><Run Background="LightYellow">Text run 3.</Run>
</TextBlock>

Das folgende Beispiel zeigt, wie die Padding-Eigenschaft programmgesteuert festgelegt wird.

TextBlock textBlock = new TextBlock(new Run("A bit of text content..."));

textBlock.Background              = Brushes.AntiqueWhite;
textBlock.Foreground              = Brushes.Navy;

textBlock.FontFamily              = new FontFamily("Century Gothic");
textBlock.FontSize                = 12;
textBlock.FontStretch             = FontStretches.UltraExpanded;
textBlock.FontStyle               = FontStyles.Italic;
textBlock.FontWeight              = FontWeights.UltraBold;

textBlock.LineHeight              = Double.NaN;
textBlock.Padding                 = new Thickness(5, 10, 5, 10);
textBlock.TextAlignment           = TextAlignment.Center;
textBlock.TextWrapping            = TextWrapping.Wrap;

textBlock.Typography.NumeralStyle = FontNumeralStyle.OldStyle;
textBlock.Typography.SlashedZero  = true;
Dim textBlock As New TextBlock(New Run("A bit of text content..."))

textBlock.Background = Brushes.AntiqueWhite
textBlock.Foreground = Brushes.Navy

textBlock.FontFamily = New FontFamily("Century Gothic")
textBlock.FontSize = 12
textBlock.FontStretch = FontStretches.UltraExpanded
textBlock.FontStyle = FontStyles.Italic
textBlock.FontWeight = FontWeights.UltraBold

textBlock.LineHeight = Double.NaN
textBlock.Padding = New Thickness(5, 10, 5, 10)
textBlock.TextAlignment = TextAlignment.Center
textBlock.TextWrapping = TextWrapping.Wrap

textBlock.Typography.NumeralStyle = FontNumeralStyle.OldStyle
textBlock.Typography.SlashedZero = True

Hinweise

Padding kann in allen Richtungen (Padding="10") als uniform oder als vier unterschiedliche Werte beschrieben werden, die den linken, oberen, rechten und unteren Abstand unabhängig voneinanderPadding="5,0,10,20" () darstellen.

Wenn eine angegebene Abstandsstärke die entsprechende Inhaltsbereichsdimension überschreitet (z. B. überschreitet die Summe der Breite des linken und rechten Abstands die Breite des Inhaltsbereichs), wird die Breite des Abstands proportional reduziert, um nicht größer als die relevante Inhaltsbereichsdimension zu sein.

Verwendung von XAML-Attributen

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

XAML-Werte

uniformThickness Zeichenfolgendarstellung eines einzelnen Double Werts, der einheitlich auf alle vier Stärkeabmessungen angewendet werden soll. Beispielsweise entspricht ein Wert von "10" einem Wert von "10,10,10,10". Ein nicht qualifizierter Wert wird in unabhängigen Pixeln des Geräts gemessen. Zeichenfolgen müssen keine dezimalen Punkte enthalten.

independentThickness Zeichenfolgendarstellung von vier sortierten Double Werten, die unabhängigen Stärkeabmessungen 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. "5.10.15.20" führt z. B. zu 5 Pixeln Abstand links vom Inhalt, 10 Pixel Abstand über Inhalt, 15 Pixel Abstand rechts vom Inhalt und 20 Pixel Abstand unterhalb des Inhalts.

qualifiedUniformThickness Ein durch uniformThickness beschriebener Wert, gefolgt von einem der folgenden Einheitenbezeichner: px, in.

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

in ist Zoll; 1in==96px

Stellt beispielsweise "1in" einen gleichmäßigen Abstand von 1 Zoll in allen Richtungen bereit.

qualifiedIndependentThickness Ein wert, der durch "independentThickness" beschrieben wird, wobei jeder unabhängige Wert gefolgt von einem der folgenden Einheitenbezeichner folgt: 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". Einheitenbezeichner können gemischt oder aus einem oder mehreren Werten weggelassen werden.

Informationen zur Abhängigkeitseigenschaft

Element Wert
Bezeichnerfeld PaddingProperty
Auf Metadateneigenschaften festgelegt true AffectsMeasure

Gilt für: