TextElement.Foreground プロパティ


要素のコンテンツに適用する Brush を取得または設定します。Gets or sets the Brush to apply to the content of the element.

 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


テキスト コンテンツに適用するために使用するブラシ。The brush used to apply to the text contents. 既定値は、Black です。The default is Black.

次の例では、Paragraph を例の要素として使用して、Foreground 属性を設定する方法を示します。The following example shows how to set the Foreground attribute, using Paragraph as the example element.

        This text has a foreground color of dark green, and a background color of bisque.

次の図は、前の例がどのようにレンダリングされるかを示しています。The following figure shows how the preceding example renders.

スクリーンショット:Green、background ビスク の前景Screenshot: Foreground of green, background bisque

次の例は、Foreground プロパティをプログラムで設定する方法を示しています。The following example shows how to set the Foreground property programmatically.

Run run = new Run(
    "This text has a foreground color of dark green, and a background color of bisque.");
Paragraph par = new Paragraph(run);

par.Background = Brushes.Bisque;
par.Foreground = Brushes.DarkGreen;
Dim run As New Run("This text has a foreground color of dark green, and a background color of bisque.")
Dim par As New Paragraph(run)

par.Background = Brushes.Bisque
par.Foreground = Brushes.DarkGreen


使用できる定義済みのブラシの色を示す見本の表については、「Brushes」を参照してください。For a table of swatches that shows the available predefined brush colors, see Brushes.

この依存関係プロパティには、プロパティの使用法も添付されています。This dependency property also has an attached property usage. XAMLXAMLでは、オブジェクトは <object TextElement.Foreground="value".../>になります。ここで、 objectTextElement内に含まれるオブジェクト要素 (通常はフロー要素) で、 valueBrush 実装値に解決される文字列です。In XAMLXAML, the usage is <object TextElement.Foreground="value".../>, where object is an object element (typically a flow element) contained within a TextElement, and value is a string that resolves to a Brush implementation value. コードでは、添付プロパティの使用は GetForeground および SetForeground メソッドによってサポートされています。In code, the attached property usage is supported by the GetForeground and SetForeground methods. 添付プロパティの使用は一般的ではありません。 TextElement に含まれる可能性のあるほとんどの要素は、コンテンツホストがレンダリングに使用する類似の非添付 Foreground プロパティをサポートしているためです。The attached property usage is not common, because most elements that can be contained in a TextElement support an analogous nonattached Foreground property, which the content host uses for rendering.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field ForegroundProperty
メタデータプロパティが true に設定されるMetadata properties set to true AffectsRenderInheritsSubPropertiesDoNotAffectRenderAffectsRender, Inherits, SubPropertiesDoNotAffectRender