TextDecorations 类

定义

命名空间:

System.Windows

程序集:

PresentationCore.dll

提供一组静态预定义文本修饰。

public ref class TextDecorations abstract sealed

public static class TextDecorations

type TextDecorations = class

Public Class TextDecorations

继承

Object

TextDecorations

示例

在以下示例中，删除线文本修饰使用默认字体值。

// Use the default font values for the strikethrough text decoration.
private void SetDefaultStrikethrough()
{
    // Set the underline decoration directly to the text block.
    TextBlock1.TextDecorations = TextDecorations.Strikethrough;
}

' Use the default font values for the strikethrough text decoration.
Private Sub SetDefaultStrikethrough()
    ' Set the underline decoration directly to the text block.
    TextBlock1.TextDecorations = TextDecorations.Strikethrough
End Sub

<!-- Use the default font values for the strikethrough text decoration. -->
<TextBlock
  TextDecorations="Strikethrough"
  FontSize="36" >
  The quick red fox
</TextBlock>

还可以为同一文本指定多个文本修饰。 在以下示例中，下划线和上划线文本修饰用于同一文本。

<!-- Use both an underline and overline text decoration for the same text. -->
<TextBlock TextDecorations="Underline, Overline">
  The quick red fox
</TextBlock>

可以使用字符串值“None”来指示集合中 TextDecorations 没有文本修饰。 在以下示例中，集合 TextDecorations 设置为“None”。

<!-- Set the text decoration collection to None to indicate no decorations. -->
<TextBlock TextDecorations="None">
  The quick red fox
</TextBlock>

可以使用 方法删除文本中的所有文本 Clear 修饰。 在以下示例中 TextDecorations ，清除了 集合。

TextBlock2.TextDecorations.Clear();

TextBlock2.TextDecorations.Clear()

默认情况下，Hyperlink 使用 TextDecoration 对象显示下划线。 以下标记示例演示使用和不使用下划线定义的 Hyperlink：

<!-- Hyperlink with default underline. -->
<Hyperlink NavigateUri="http://www.msn.com">
  MSN Home
</Hyperlink>

<Run Text=" | " />

<!-- Hyperlink with no underline. -->
<Hyperlink Name="myHyperlink" TextDecorations="None"
           MouseEnter="OnMouseEnter"
           MouseLeave="OnMouseLeave"
           NavigateUri="http://www.msn.com">
  My MSN
</Hyperlink>

实例化 TextDecoration 对象可能会占用大量性能，尤其是在拥有许多 Hyperlink 对象的情况下。 有关详细信息，请参阅 如何：指定超链接是否带下划线。

注解

有四种类型的文本修饰：基线、超行、删除线和下划线。 以下示例显示了文本修饰相对于文本的位置。

文本修饰类型示例

XAML 属性用法

<object textDecorationsProperty="textDecorationType[,textDecorationType]"/>  

XAML 值

textDecorationType
文本修饰的类型： Baseline、 OverLine、 Strikethrough或 Underline。 允许使用多个修饰，值用逗号分隔。 还可以指定“None”来指示没有文本修饰类型。

属性

Baseline	指定一个基线 TextDecoration。
OverLine	指定一个上划线 TextDecoration。
Strikethrough	指定一个删除线 TextDecoration。
Underline	指定一个下划线 TextDecoration。