TextBlock.Padding 属性

定义

命名空间:

System.Windows.Controls

程序集:

PresentationFramework.dll

获取或设置一个值，该值指示内容区域的边界之间填充空间的宽度，以及由 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

属性值

Thickness

一个 Thickness 结构，它指定要应用的边距量（以与设备无关的像素为单位）。 默认值为 NaN。

示例

以下示例演示如何设置 Padding 元素的 TextBlock 属性。

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

以下示例演示如何以编程方式设置 Padding 属性。

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

注解

Padding 可以描述为所有方向 (Padding="10") 统一，或描述为四个不同值，分别表示左、上、右和下填充 (Padding="5,0,10,20") 。

例如，如果指定的填充粗细超过相应的内容区域维度 (左右填充宽度之和超过内容区域宽度) ，则填充的粗细按比例减小为不大于相关内容区域维度。

XAML 属性用法

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

XAML 值

uniformThickness
要统一应用于所有四个厚度维度的单个 Double 值的字符串表示形式。 例如， 的 值 "10" 等效于 的值 "10,10,10,10"。 非限定值以与设备无关的像素度量。 字符串不需要显式包含小数点。

independentThickness
四个有序 Double 值的字符串表示形式，对应于左、上、右和下的独立粗细尺寸，按此顺序排列。 四个值必须用逗号分隔;不允许使用空格。 例如，“5，10，15，20”导致内容左侧填充 5 像素，内容上方 10 像素填充，内容右侧填充 15 像素，内容下方填充 20 像素。

qualifiedUniformThickness
由 uniformThickness 描述的值，后跟以下单位说明符之一： px、 in。

px (默认) 为与设备无关的单位， (单位) 1/96 英寸

in 为英寸;1in==96px

例如， "1in" 在所有方向上提供 1 英寸的均匀填充。

qualifiedIndependentThickness
由 independentThickness 描述的值，每个独立值后跟下列单位说明符之一： px、 in。

px (默认) 为与设备无关的单位， (单位) 1/96 英寸

in 为英寸;1in==96px

例如，"1.5in,0.8in,1.5in,0.8in"。 一个或多个值可以混合或省略单位说明符。

依赖项属性信息

标识符字段	PaddingProperty
元数据属性设置为 true	AffectsMeasure