TextBlock.Foreground 屬性

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>

屬性值

筆刷過去會套用到文字內容上。 從純程式碼角度來看，預設是空筆刷，但預設的文字樣式會將 TextBlock 元素設定為黑色（淺色主題）或白色（暗色主題）。

範例

以下 XAML 範例展示了如何利用內嵌定義的屬性值「Maroon」將前景屬性設定為純色。 XAML 解析器使用此「Maroon」值來參考命名的顏色 Colors.Maroon，並建立提供執行時間值的 SolidColorBrush 實例。

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

備註

TextBlock 不是控制項，所以你不會用範本來改變它的外觀。 相反地，你可以用風格。 使用命名樣式來呈現 TextBlock 外觀比為每個 TextBlock 實例設定內嵌屬性更常見（也更為有效），尤其是當你在多個元素中使用共用值時。 欲了解更多樣式資訊，請參見 XAML 樣式。

文字的預設外觀及文字樣式高度依賴於活動主題及其他設定。 主題以及使用預設系統設定或使用者偏好的各種風格與行為，是 TextBlock 有效執行時外觀的來源，前台顏色及其他文字特性。 你可以透過更改屬性值，或對特定的 TextBlock 實例套用不同的樣式來改變這些預設值。 你可以透過覆寫 App.xaml 中名為 DefaultTextForegroundThemeBrush 的資源來更改所有預設文字的前景值。

另請參閱

• 文字區塊
• XAML 筆刷