情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

TextBlock.Foreground プロパティ

2013/12/12

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

Namespace:  System.Windows.Controls
アセンブリ:  System.Windows (System.Windows.dll 内)
XAML の XMLNS: xmlns にマップされていません。

public Brush Foreground { get; set; }
<TextBlock>
  <TextBlock.Foreground>
    singleBrush
  </TextBlock.Foreground>
</TextBlock>
<TextBlock Foreground="colorString"/>

XAML 値

singleBrush

Brush から派生するオブジェクトの単一のオブジェクト要素。通常、このオブジェクト要素は、Windows Phone が定義している LinearGradientBrushRadialGradientBrushImageBrushSolidColorBrush, VideoBrush のクラスのいずれかです。

colorString

属性の文字列値として表現された SolidColorBrushColor。これには、名前付きの色、RGB 値、ScRGB 値のいずれかを使用できます。RGB または ScRGB 値ではアルファ情報を指定することもできます。詳細については、Brush のトピックの「XAML 値」および「定義済みの色」を参照してください。

プロパティ値

型: System.Windows.Media.Brush
テキスト コンテンツに適用するブラシ。既定値は BlackColor 値を持つ SolidColorBrush です。

依存関係プロパティの識別子フィールド:  ForegroundProperty

Foreground プロパティは、レンダリングされたテキストの Brush を指定します。Brush は、純色、線形グラデーション、放射状グラデーション、またはイメージを表すことができます。

SolidColorBrush などの一部のブラシ型では XAML 属性構文がサポートされます。ImageBrushLinearGradientBrush、および RadialGradientBrush などの他のブラシ型では、オブジェクト要素構文のみがサポートされます。このため、このプロパティの XAML 構文は 2 つの形式が示されています。

Black の既定値は、プロパティ システム レベルでの既定です。TextBlock がコントロールの複合要素として存在する場合、既定のスタイルにより値が設定されたか、または親コントロールまたは既定のスタイルから値を継承している可能性が高くなります。テキスト要素がプロパティ値を継承する方法の詳細については、「Windows Phone のテキストとフォント」を参照してください。

Foreground をアニメーション化するときは、間接的な対象化を使用する必要があります。たとえば、TextBlockForeground である SolidColorBrush の色をアニメーション化するには、次を使用できます。

<ColorAnimation ... Storyboard.TargetProperty="(TextBlock.Foreground).(SolidColorBrush.Color)" />.

Run 子要素の Foreground 設定は、格納されている TextBlock の設定をオーバーライドします。

Foreground プロパティを純色と線形グラデーションに設定する方法を次の XAML の例に示します。

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

<!-- TextBlock with a linear-gradient brush applied to the text. -->
<TextBlock
  Canvas.Top="100"
  FontFamily="Verdana"
  FontSize="32"
  FontWeight="Bold">
  LINEAR GRADIENT BRUSH
  <TextBlock.Foreground>
    <LinearGradientBrush StartPoint="0,0" EndPoint="1,1">
      <GradientStop Color="Red" Offset="0.0" />
      <GradientStop Color="Orange" Offset="0.2" />
      <GradientStop Color="Yellow" Offset="0.4" />
      <GradientStop Color="Green" Offset="0.6" />
      <GradientStop Color="Blue" Offset="0.8" />
      <GradientStop Color="Violet" Offset="1.0" />
    </LinearGradientBrush>
  </TextBlock.Foreground>
</TextBlock>

Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示: