TextBlock.Foreground 屬性

定義

命名空間:

Microsoft.UI.Xaml.Controls

取得或設定要套用至 TextBlock 文字內容的 Brush。

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 筆刷