TextBlock.Padding Propiedad

Definición

Obtiene o establece un valor que indica el grosor del espacio de relleno entre los límites del área de contenido y el contenido mostrado por 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 de propiedad

Estructura Thickness que especifica la cantidad de relleno que se aplicará, en píxeles independientes del dispositivo. De manera predeterminada, es NaN.

Ejemplos

En el ejemplo siguiente se muestra cómo establecer el Padding atributo de un 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>

En el ejemplo siguiente se muestra cómo establecer la propiedad Padding mediante programación.

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

Comentarios

Padding se puede describir como uniforme en todas las direcciones (Padding="10"), o como cuatro valores distintos que representan el relleno izquierdo, superior, derecho e inferior de forma independiente (Padding="5,0,10,20").

Si un grosor de relleno especificado supera la dimensión de área de contenido correspondiente (por ejemplo, la suma de los anchos de relleno izquierdo y derecho supera el ancho del área de contenido), el grosor del relleno se reduce proporcionalmente a no ser mayor que la dimensión de área de contenido pertinente.

Uso de atributos XAML

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

Valores XAML

uniformThickness
Representación de cadena de un valor único Double que se va a aplicar uniformemente a las cuatro dimensiones de grosor. Por ejemplo, un valor de "10" es equivalente a un valor de "10,10,10,10". Un valor no completo se mide en píxeles independientes del dispositivo. Las cadenas no necesitan incluir explícitamente puntos decimales.

independentThickness
Representación de cadena de cuatro valores ordenados Double correspondientes a dimensiones de grosor independientes para las dimensiones izquierda, superior, derecha e inferior, en este orden. Los cuatro valores deben estar separados con comas; no se permiten espacios. Por ejemplo, "5,10,15,20" da como resultado 5 píxeles de relleno a la izquierda del contenido, 10 píxeles de relleno encima del contenido, 15 píxeles de relleno a la derecha del contenido y 20 píxeles de relleno debajo del contenido.

qualifiedUniformThickness
Valor descrito por uniformThickness seguido de uno de los siguientes especificadores de unidad: px, in.

px (valor predeterminado) es unidades independientes del dispositivo (1/96 pulgadas por unidad)

in es pulgadas; 1in==96px

Por ejemplo, "1in" proporciona relleno uniforme de 1 pulgada en todas las direcciones.

qualifiedIndependentThickness
Valor descrito por independentThickness, con cada valor independiente seguido de uno de los siguientes especificadores de unidad: px, in.

px (valor predeterminado) es unidades independientes del dispositivo (1/96 pulgadas por unidad)

in es pulgadas; 1in==96px

Por ejemplo, "1.5in,0.8in,1.5in,0.8in". Los especificadores de unidad se pueden mezclar o omitir de uno o varios valores.

Información sobre propiedades de dependencia

Campo identificador PaddingProperty
Propiedades de metadatos establecidas en true AffectsMeasure

Se aplica a