Procedura: specificare se un collegamento ipertestuale è sottolineatoHow to: Specify Whether a Hyperlink is Underlined

Il Hyperlink oggetto è un elemento di contenuto di flusso di livello inline che consente di ospitare collegamenti ipertestuali all'interno del contenuto di flusso.The Hyperlink object is an inline-level flow content element that allows you to host hyperlinks within the flow content. Per impostazione predefinita, Hyperlink utilizza un TextDecoration oggetto per visualizzare un carattere di sottolineatura.By default, Hyperlink uses a TextDecoration object to display an underline. TextDecoration gli oggetti possono essere prestazioni elevate per creare un'istanza, in particolare se si dispone di numerosi Hyperlink oggetti.TextDecoration objects can be performance intensive to instantiate, particularly if you have many Hyperlink objects. Se si usano ampiamente Hyperlink elementi, si consiglia di provare a visualizzare un carattere di sottolineatura solo al momento della generazione di un evento, ad esempio il MouseEnter evento.If you make extensive use of Hyperlink elements, you may want to consider showing an underline only when triggering an event, such as the MouseEnter event.

Nell'esempio seguente, la sottolineatura per il collegamento "My MSN" è dinamica, viene visualizzata solo quando il MouseEnter evento viene generato.In the following example, the underline for the "My MSN" link is dynamic—it only appears when the MouseEnter event is triggered.

Collegamenti ipertestuali con TextDecorationHyperlinks displaying TextDecorations
Collegamenti ipertestuali definiti con TextDecorationsHyperlinks defined with TextDecorations

EsempioExample

Nell'esempio di codice seguente viene illustrato un Hyperlink definito con e senza un carattere di sottolineatura:The following markup sample shows a Hyperlink defined with and without an underline:

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

Esempio di codice riportato di seguito viene illustrato come creare un carattere di sottolineatura per il Hyperlink sul MouseEnter evento e rimuoverlo nel MouseLeave evento.The following code sample shows how to create an underline for the Hyperlink on the MouseEnter event, and remove it on the MouseLeave event.

// 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;
}
' Display the underline on only the MouseEnter event.
Private Overloads Sub OnMouseEnter(ByVal sender As Object, ByVal e As EventArgs)
	myHyperlink.TextDecorations = TextDecorations.Underline
End Sub

' Remove the underline on the MouseLeave event.
Private Overloads Sub OnMouseLeave(ByVal sender As Object, ByVal e As EventArgs)
	myHyperlink.TextDecorations = Nothing
End Sub

Vedere ancheSee Also

TextDecoration
Hyperlink
Ottimizzazione delle prestazioni di applicazioni WPFOptimizing WPF Application Performance
Creare un effetto di testoCreate a Text Decoration