MSDN Library
信息
您所需的主题如下所示。但此主题未包含在此库中。

TextBlock.Foreground 属性

2013/12/13

获取或设置要应用于 TextBlock 的文本内容的 Brush

Namespace:  System.Windows.Controls
程序集:  System.Windows(位于 System.Windows.dll 中)
XMLNS for XAML: 未映射到 xmlns。

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

XAML 值

singleBrush

Brush 派生的对象的单个对象元素。该对象元素通常是由 Windows Phone 定义的下列类之一:LinearGradientBrush, RadialGradientBrush, ImageBrush, SolidColorBrush, VideoBrush.

colorString

SolidColorBrushColor,表示为属性的字符串值。这可以是一个指定的颜色、一个 RGB 值或者一个 ScRGB 值。RGBScRGB 值还可以指定 alpha 信息。有关更多信息,请参见 Brush 中的"XAML 值"和"预定义颜色"部分。

属性值

类型: System.Windows.Media.Brush
要应用于文本内容的画笔。默认值为 SolidColorBrush,其 Color 值为 Black

依赖项属性标识符字段: ForegroundProperty

Foreground 属性为所呈现文本指定 BrushBrush 可以表示纯色、线性/径向渐变或图像。

某些画笔类型(例如,SolidColorBrush)支持 XAML 属性语法。其他画笔类型(例如,ImageBrushLinearGradientBrushRadialGradientBrush)值支持对象元素语法。这就是演示此属性的两个版本的 XAML 语法的原因。

Black 默认值是属性系统级别上的默认值。当 TextBlock 作为某控件的复合元素存在时,该值很有可能已按默认样式进行设置,或者从父控件或其默认样式继承其值。有关文本元素如何能够继承属性值的更多信息,请参见Windows Phone 的文本和字体

在对 Foreground 进行动画处理时,必须使用间接目标。例如,要对 SolidColorBrush(它是 TextBlockForeground)的颜色进行动画处理,您可以使用以下内容:

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

Run 子元素的 Foreground 设置将重写包含该子元素的 TextBlock 的相应设置。

下面的 XAML 示例演示如何将 Foreground 属性设置为纯色和线性渐变。

<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

Windows Phone

显示:
© 2016 Microsoft