TextBlock.Foreground プロパティ

定義

名前空間:

Microsoft.UI.Xaml.Controls

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

public:
 property Brush ^ Foreground { Brush ^ get(); void set(Brush ^ value); };

Brush Foreground();

void Foreground(Brush value);

public Brush Foreground { get; set; }

var brush = textBlock.foreground;
textBlock.foreground = brush;

Public Property Foreground As Brush

<TextBlock Foreground="{StaticResource resourceName}"/>
- or -
<TextBlock Foreground="colorString"/>
- or -
<TextBlock>
  <TextBlock.Foreground>singleBrush</TextBlock.Foreground>
</TextBlock>

プロパティ値

Brush

テキスト コンテンツに適用するために使用するブラシ。 既定値は純粋なコードの観点から見た null ブラシですが、既定のテキスト スタイルでは、UI の TextBlock 要素に対して黒 (ライト テーマの場合) または白 (濃色テーマの場合) に設定されます。

例

次の XAML の例は、インライン定義の属性値 "Maroon" を使用して Foreground プロパティを単色に設定する方法を示しています。 XAML パーサーは、この "Maroon" 値を使用して、名前付き色 Colors.Maroon を参照し、ランタイム値を提供する SolidColorBrush インスタンスを作成します。

<TextBlock
  FontSize="32"
  FontWeight="Bold"
  Foreground="Maroon">
  Maroon
</TextBlock>

注釈

TextBlock はコントロールではないので、テンプレートを使用してその外観を変更することはありません。 代わりに、スタイルを使用できます。 TextBlock の外観に名前付きスタイルを使用する方が一般的です (特に、多くの要素で共通の値を使用している場合は特に、各 TextBlock インスタンスにインライン属性を設定するよりも)。 スタイルの詳細については、「 XAML スタイル」を参照してください。

テキストスタイルとテキストスタイルの既定の外観は、アクティブなテーマやその他の設定によって大きく異なります。 既定のシステム設定またはユーザー設定を使用するテーマとさまざまなスタイルと動作は、 テキストの TextBlock 前景色とその他のテキスト特性の有効な実行時の外観のソースです。 これらの既定値は、プロパティ値を変更するか、特定の TextBlock インスタンスに別のスタイルを適用することで変更できます。 App.xaml で DefaultTextForegroundThemeBrush という名前のリソースをオーバーライドすることで、すべての既定のテキストの前景の値を変更できます。

こちらもご覧ください

• テキスト ブロック
• XAML ブラシ