TextDecorations Classe

Definição

public ref class TextDecorations abstract sealed

public static class TextDecorations

type TextDecorations = class

Public Class TextDecorations

Herança

Object

TextDecorations

Exemplos

No exemplo seguinte, uma decoração de texto riscado usa o valor de 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>

Também pode especificar várias decorações de texto para o mesmo texto. No exemplo seguinte, uma decoração de texto sublinhada e uma decoração de texto por cima 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>

Pode usar o valor da cadeia "Nenhum" para indicar que não há decorações de texto na TextDecorations coleção. No exemplo seguinte, a TextDecorations coleção está definida como "Nenhuma".

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

Pode remover todas as decorações de texto usando o Clear método. No exemplo seguinte, a TextDecorations coleção é limpa.

TextBlock2.TextDecorations.Clear();

TextBlock2.TextDecorations.Clear()

Por defeito, Hyperlink usa um TextDecoration objeto para mostrar um sublinhado. O exemplo de marcação a seguir mostra um Hyperlink definido com e sem 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 exigir muito desempenho para instanciar, especialmente se tiveres muitos Hyperlink objetos. Para mais informações, veja Como: Especificar se um hiperlink está sublinhado.

Observações

Existem quatro tipos de decorações de texto: linha de base, sobrelinha, risca e sublinhada. O exemplo seguinte mostra as localizações das decorações do texto em relação ao texto.

Exemplo de tipos de decoração de texto

Uso de atributos XAML

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

Valores XAML

textDecorationType O tipo de decoração de texto: Baseline, OverLine, Strikethrough, ou Underline. São permitidas mais do que uma decoração, com valores separados por vírgulas. Também pode especificar "Nenhum" para indicar que não há nenhum tipo de decoração de texto.