TextBlock.Padding Свойство

Определение

Получается или задает значение, указывающее толщину отбивки между границами области содержимого и содержимым, отображаемым 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, которая указывает применяемое значение заполнения в аппаратно-независимых пикселях. Значение по умолчанию — 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

Применяется к