Compartilhar via


Como: Use a Text Decoration with a Hyperlink

O objeto Hyperlink é um elemento de conteúdo de nível interno que permite você ter hiperlinks dentro do conteúdo de fluxo. Por padrão, Hyperlink usa um TextDecoration objeto para exibir um sublinhado. TextDecoration os objetos podem ser desempenho intensivo, para criar uma instância, especialmente se você tiver muitos Hyperlink objetos. Se você fizer uso extensivo de elementos Hyperlink, você pode querer considerar mostrar um sublinhado somente quando ativando um evento, tal como o evento MouseEnter.

No exemplo seguinte, o sublinhado para o link "My MSN" é dinâmico, só aparece quando o evento MouseEnter é ativado.

Hiperlink definido com TextDecorations

Hiperlinks exibindo TextDecorations

Exemplo

O exemplo a seguir de marcação mostra um Hyperlink definido com e sem sublinhado:

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

<Run Text=" | " />

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

O exemplo de código a seguir mostra como criar um "sublinhado" para o Hyperlink no evento MouseEnter e removê-lo no evento MouseLeave.

// Display the underline on only the MouseEnter event.
private void OnMouseEnter(object sender, EventArgs e)
{
    myHyperlink.TextDecorations = TextDecorations.Underline;
}

// Remove the underline on the MouseLeave event.
private void OnMouseLeave(object sender, EventArgs e)
{
    myHyperlink.TextDecorations = null;
}

Consulte também

Tarefas

Como: Criar um enfeite de texto

Conceitos

Optimizing WPF Application Performance

Referência

TextDecoration

Hyperlink