TextBlock.Foreground プロパティ

定義

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>

プロパティ値

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

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

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

注釈

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

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

適用対象

こちらもご覧ください