TextBlock.Foreground プロパティ

定義

TextBlock のテキスト コンテンツに適用する Brush を取得または設定します。

public:
 property System::Windows::Media::Brush ^ Foreground { System::Windows::Media::Brush ^ get(); void set(System::Windows::Media::Brush ^ value); };
public System.Windows.Media.Brush Foreground { get; set; }
member this.Foreground : System.Windows.Media.Brush with get, set
Public Property Foreground As Brush

プロパティ値

テキスト コンテンツに適用するために使用するブラシ。 既定値は、Black です。

次の例は、 要素の 属性を Foreground 設定する方法を 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>

次の例では、Foreground プロパティをプログラムで設定する方法を示しています。

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

注釈

使用可能な定義済みのブラシの色を示す見本のテーブルについては、「」を参照してください Brushes

子要素の設定はすべて Foreground 、この最上位レベルの設定をオーバーライドします。

この依存関係プロパティには、添付プロパティの使用法もあります。 XAML では、使用法は です <object TextBlock.Foreground="value".../>object は 内 TextBlockに含まれるオブジェクト要素 (通常はフロー要素) であり、 value は実装値に Brush 解決される文字列です。 コードでは、添付プロパティの使用法は と SetForegroundGetForegroundサポートされています。 添付プロパティの使用法は一般的ではありません。これは、 に含めることができるほとんどの要素が、レンダリングに TextBlock 使用する類似の非アタッチ Foreground プロパティを TextBlock サポートするためです。

依存プロパティ情報

識別子フィールド ForegroundProperty
に設定されたメタデータ プロパティ true AffectsRender, SubPropertiesDoNotAffectRender, Inherits

適用対象