TextBlock.Padding Propriété

Définition

Obtient ou définit une valeur qui indique l’épaisseur de l’espace de remplissage entre les limites de la zone de contenu et le contenu affiché par 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

Valeur de propriété

Structure Thickness spécifiant la quantité de remplissage à appliquer, en pixels indépendants du périphérique La valeur par défaut est NaN.

Exemples

L’exemple suivant montre comment définir l’attribut Padding d’un TextBlock élément.

<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>

L’exemple suivant montre comment définir la Padding propriété par programmation.

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

Remarques

Padding peut être décrit comme uniforme dans toutes les directions (Padding="10"), ou comme quatre valeurs distinctes qui représentent le remplissage à gauche, en haut, à droite et en bas indépendamment (Padding="5,0,10,20").

Si une épaisseur de remplissage spécifiée dépasse la dimension de zone de contenu correspondante (par exemple, la somme des largeurs de remplissage gauche et droite dépasse la largeur de la zone de contenu), l’épaisseur du remplissage est réduite proportionnellement pour ne pas être supérieure à la dimension de zone de contenu appropriée.

Utilisation d'attributs XAML

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

Valeurs XAML

uniformThickness
Représentation sous forme de chaîne d’une valeur unique Double à appliquer uniformément aux quatre dimensions d’épaisseur. Par exemple, une valeur de "10" équivaut à une valeur de "10,10,10,10". Une valeur non qualifiée est mesurée en pixels indépendants de l’appareil. Les chaînes n’ont pas besoin d’inclure explicitement des décimales.

independentThickness
Représentation sous forme de chaîne de quatre valeurs ordonnées Double correspondant à des dimensions d’épaisseur indépendantes pour la gauche, le haut, la droite et le bas, dans cet ordre. Les quatre valeurs doivent être séparées par des virgules ; les espaces ne sont pas autorisés. Par exemple, « 5,10,15,20 » entraîne 5 pixels de remplissage à gauche du contenu, 10 pixels de remplissage au-dessus du contenu, 15 pixels de remplissage à droite du contenu et 20 pixels de remplissage sous le contenu.

qualifiedUniformThickness
Valeur décrite par uniformThickness suivie de l’un des spécificateurs d’unité suivants : px, in.

px (valeur par défaut) est des unités indépendantes de l’appareil (1/96e pouce par unité)

in est en pouces ; 1in==96px

Par exemple, "1in" fournit un remplissage uniforme de 1 pouce dans toutes les directions.

qualifiedIndependentThickness
Valeur décrite par independentThickness, avec chaque valeur indépendante suivie de l’un des spécificateurs d’unité suivants : px, in.

px (valeur par défaut) est des unités indépendantes de l’appareil (1/96e pouce par unité)

in est en pouces ; 1in==96px

Par exemple : "1.5in,0.8in,1.5in,0.8in". Les spécificateurs d’unités peuvent être mixtes ou omis d’une ou plusieurs valeurs.

Informations sur les propriétés de dépendance

Champ Identificateur PaddingProperty
Propriétés de métadonnées définies sur true AffectsMeasure

S’applique à