TextBlock.Foreground プロパティ

定義

Brush のテキスト コンテンツに適用する TextBlock を取得または設定します。Gets or sets the Brush to apply to the text contents of the TextBlock.

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

プロパティ値

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

次の例は、TextBlock 要素の Foreground 属性を設定する方法を示しています。The following example shows how to set the Foreground attribute of a TextBlock element.

<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 プロパティをプログラムで設定する方法を示しています。The following example shows how to set the Foreground property programmatically.

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」を参照してください。For a table of swatches that show the available pre-defined brush colors, see Brushes.

子要素の Foreground 設定は、この最上位レベルの設定よりも優先されます。Any Foreground settings on child elements override this top-level setting.

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

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

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

適用対象