TextDecoration.Pen 屬性

定義

命名空間:

System.Windows

組件:

PresentationCore.dll

取得或設定用於繪製文字裝飾的 Pen。

C#

public System.Windows.Media.Pen Pen { get; set; }

屬性值

Pen

用於繪製文字裝飾的 Pen。 如果此值為 null ，裝飾色彩會比對所套用的文字，而且裝飾的粗細會設定為字型的建議粗細。

範例

在下列程式碼範例中，會使用虛線畫筆的線性漸層筆刷來建立底線文字裝飾。

C#

// Use a linear gradient pen for the underline text decoration.
private void SetLinearGradientUnderline()
{
    // Create an underline text decoration. Default is underline.
    TextDecoration myUnderline = new TextDecoration();

    // Create a linear gradient pen for the text decoration.
    Pen myPen = new Pen();
    myPen.Brush = new LinearGradientBrush(Colors.Yellow, Colors.Red, new Point(0, 0.5), new Point(1, 0.5));
    myPen.Brush.Opacity = 0.5;
    myPen.Thickness = 1.5;
    myPen.DashStyle = DashStyles.Dash;
    myUnderline.Pen = myPen;
    myUnderline.PenThicknessUnit = TextDecorationUnit.FontRecommended;

    // Set the underline decoration to a TextDecorationCollection and add it to the text block.
    TextDecorationCollection myCollection = new TextDecorationCollection();
    myCollection.Add(myUnderline);
    TextBlock3.TextDecorations = myCollection;
}

XAML

<!-- Use a linear gradient pen for the underline text decoration. -->
<TextBlock FontSize="36">the lazy brown dog.
  <TextBlock.TextDecorations>
    <TextDecorationCollection>
      <TextDecoration  
        PenThicknessUnit="FontRecommended">
        <TextDecoration.Pen>
          <Pen Thickness="1.5">
            <Pen.Brush>
              <LinearGradientBrush Opacity="0.5"
                StartPoint="0,0.5"  EndPoint="1,0.5">
                <LinearGradientBrush.GradientStops>
                  <GradientStop Color="Yellow" Offset="0" />
                  <GradientStop Color="Red" Offset="1" />
                </LinearGradientBrush.GradientStops>
              </LinearGradientBrush>
            </Pen.Brush>
            <Pen.DashStyle>
              <DashStyle Dashes="2"/>
            </Pen.DashStyle>
          </Pen>
        </TextDecoration.Pen>
      </TextDecoration>
    </TextDecorationCollection>
  </TextBlock.TextDecorations>
</TextBlock>

備註

下列範例顯示已使用線性漸層筆刷和虛線畫筆設定樣式的文字裝飾。

使用線性漸層筆刷和虛線畫筆設定樣式的底線範例

相依性屬性資訊

識別碼欄位	PenProperty
中繼資料屬性設定為 true	無

適用於

另請參閱

• PenThicknessUnit