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は、すべての方向で均一 ()、または左、上、右、および下のパディングを個別に表す 4 つの異なる値として記述できます (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
4 つの厚み寸法すべてに均一に適用する 1 つの Double 値の文字列表現。 たとえば、 の "10" 値は の "10,10,10,10"値と同じです。 非修飾値は、デバイスに依存しないピクセル単位で測定されます。 文字列に小数点を明示的に含める必要はありません。

independentThickness
左、上、右、および下の独立した厚み寸法に対応する 4 つの順序付けられた Double 値の文字列表現 (この順序)。 4 つの値はコンマで区切る必要があります。スペースは使用できません。 たとえば、"5,10,15,20" の場合、コンテンツの左側に 5 ピクセルのパディング、コンテンツの上に 10 ピクセル、コンテンツの右側に 15 ピクセルのパディング、コンテンツの下に 20 ピクセルのパディングが行われます。

qualifiedUniformThickness
uniformThickness で記述された値の後に、次のいずれかの単位指定子 px(、in) が続きます。

px (既定値) はデバイスに依存しない単位 (ユニットあたり 1/96 インチ) です

in はインチ。1in==96px

たとえば、 "1in" は、すべての方向に 1 インチの均一なパディングを提供します。

qualifiedIndependentThickness
independentThickness で記述された値。各独立値の後に、次のいずれかの単位指定子が続きます。 pxin

px (既定値) はデバイスに依存しない単位 (ユニットあたり 1/96 インチ) です

in はインチ。1in==96px

たとえば、「 "1.5in,0.8in,1.5in,0.8in" 」のように入力します。 単位指定子は、1 つ以上の値から混合または省略できます。

依存プロパティ情報

識別子フィールド	PaddingProperty
に設定されたメタデータ プロパティ true	AffectsMeasure