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

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

Поделиться через