Comment : utiliser une décoration de texte avec un lien hypertexte

Mise à jour : novembre 2007

L'objet Hyperlink est un élément inclus de contenu de flux qui vous permet d'héberger des liens hypertexte au sein du contenu du flux. Par défaut, Hyperlink utilise un objet TextDecoration pour afficher un soulignement. L'instanciation d'objets TextDecoration peut être exigeante en termes de performances, en particulier si vous avez un grand nombre d'objets Hyperlink. Si vous utilisez beaucoup d'éléments Hyperlink, envisagez d'afficher un soulignement uniquement lors du déclenchement d'un événement, tel que MouseEnter.

Dans l'exemple suivant, le soulignement du lien "My MSN" est dynamique : il s'affiche uniquement lorsque l'événement MouseEnter est déclenché.

Hyperliens définis à l'aide de décorations de texte

Exemple

L'exemple de balise suivant affiche un Hyperlink défini avec et sans soulignement :

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

L'exemple de code suivant montre comment créer un soulignement pour le Hyperlink sur l'événement MouseEnter et le supprimer sur l'événement 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;
}

Voir aussi

Tâches

Comment : créer une décoration de texte

Concepts

Optimisation des performances des applications WPF

Référence

TextDecoration

Hyperlink