TextBlock.Padding Propriedade

Definição

Obtém ou define um valor que indica a espessura do espaço de preenchimento entre os limites da área de conteúdo e o conteúdo exibido por um 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

Valor da propriedade

Uma estrutura Thickness que especifica a quantidade de preenchimento a aplicar, em pixels independentes de dispositivo. O padrão é NaN.

Exemplos

O exemplo a seguir mostra como definir o Padding atributo de um TextBlock elemento .

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

O exemplo a seguir mostra como definir a Padding propriedade programaticamente.

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

Comentários

Padding pode ser descrito como uniforme em todas as direções (Padding="10") ou como quatro valores distintos que representam o preenchimento esquerdo, superior, direito e inferior independentemente (Padding="5,0,10,20").

Se uma espessura de preenchimento especificada exceder a dimensão de área de conteúdo correspondente (por exemplo, a soma das larguras de preenchimento à esquerda e à direita excede a largura da área de conteúdo), a espessura do preenchimento é proporcionalmente reduzida para não ser maior do que a dimensão da área de conteúdo relevante.

Uso do Atributo XAML

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

Valores XAML

uniformThickness
Representação de cadeia de caracteres de um único Double valor a ser aplicado uniformemente a todas as quatro dimensões de espessura. Por exemplo, um valor de "10" é equivalente a um valor de "10,10,10,10". Um valor não qualificado é medido em pixels independentes do dispositivo. As cadeias de caracteres não precisam incluir explicitamente pontos decimais.

independentThickness
Representação de cadeia de caracteres de quatro valores ordenados Double correspondentes a dimensões de espessura independentes para esquerda, superior, direita e inferior, nesta ordem. Os quatro valores devem ser separados com vírgulas; espaços não são permitidos. Por exemplo, "5,10,15,20" resulta em 5 pixels de preenchimento à esquerda do conteúdo, 10 pixels de preenchimento acima do conteúdo, 15 pixels de preenchimento à direita do conteúdo e 20 pixels de preenchimento abaixo do conteúdo.

qualifiedUniformThickness
Um valor descrito por uniformThickness seguido por um dos seguintes especificadores de unidade: px, in.

px (padrão) são unidades independentes do dispositivo (1/96 polegada por unidade)

in é polegadas; 1in==96px

Por exemplo, "1in" fornece preenchimento uniforme de 1 polegada em todas as direções.

qualifiedIndependentThickness
Um valor descrito por independentThickness, com cada valor independente seguido por um dos seguintes especificadores de unidade: px, in.

px (padrão) são unidades independentes do dispositivo (1/96 polegada por unidade)

in é polegadas; 1in==96px

Por exemplo, "1.5in,0.8in,1.5in,0.8in". Os especificadores de unidade podem ser mistos ou omitidos de um ou mais valores.

Informações da propriedade de dependência

Campo Identificador PaddingProperty
Propriedades de metadados definidas como true AffectsMeasure

Aplica-se a