TextBlock.Padding Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, mit dem die Größe des Abstands zwischen den Begrenzungen des Inhaltsbereichs und dem von einem TextBlock angezeigten Inhalt angegeben wird, oder legt ihn 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 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 Sie die Padding-Eigenschaft programmatisch einstellen können.

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 als einheitlich in alle Richtungen (Padding="10") oder als vier unterschiedliche Werte beschrieben werden, die die linke, obere, rechte und untere Füllung unabhängig voneinander darstellen (Padding="5,0,10,20").

Wenn eine angegebene Polsterstärke die entsprechende Inhaltsbereichsdimension überschreitet (z. B. überschreitet die Summe der linken und rechten Polsterbreite die Inhaltsbereichsbreite), wird die Dicke der Füllung 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

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. "5,10,15,20" führt beispielsweise 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

Gilt für:

Freigeben über