TextDecorations Classe

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Fornece um conjunto de decorações de texto predefinido estático.

public ref class TextDecorations abstract sealed

public static class TextDecorations

type TextDecorations = class

Public Class TextDecorations

Herança

Object

TextDecorations

Exemplos

No exemplo a seguir, uma decoração de texto strikethrough usa o valor da fonte padrão.

// 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>

Você também pode especificar várias decorações de texto para o mesmo texto. No exemplo a seguir, uma decoração de texto sublinhado e overline são usadas para o mesmo texto.

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

Você pode usar o valor de cadeia de caracteres "Nenhum" para indicar que não há decorações de texto na TextDecorations coleção. No exemplo a seguir, a TextDecorations coleção é definida como "Nenhum".

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

Você pode remover todas as decorações de texto do texto usando o Clear método. No exemplo a seguir, a TextDecorations coleção é desmarcada.

TextBlock2.TextDecorations.Clear();

TextBlock2.TextDecorations.Clear()

Por padrão, Hyperlink usa um TextDecoration objeto para exibir um sublinhado. O exemplo de marcação a seguir mostra um Hyperlink definido com e sem um sublinhado:

<!-- 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 os objetos podem ser intensivos em desempenho para instanciar, especialmente se você tiver muitos Hyperlink objetos. Para obter mais informações, consulte Como especificar se um hiperlink está sublinhado.

Comentários

Há quatro tipos de decorações de texto: linha de base, linha de base, tachado e sublinhado. O exemplo a seguir mostra os locais das decorações de texto em relação ao texto.

Exemplo de tipos de decoração de texto

Uso do Atributo XAML

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

Valores XAML

textDecorationType
O tipo de decoração de texto: Baseline, OverLine, ou StrikethroughUnderline. Mais de uma decoração é permitida, com valores separados por vírgulas. Você também pode especificar "Nenhum" para indicar nenhum tipo de decoração de texto.

Propriedades

Baseline	Especifica uma linha de base TextDecoration.
OverLine	Especifica um TextDecoration sobreposto.
Strikethrough	Especifica um tachado TextDecoration.
Underline	Especifica um TextDecoration sublinhado.