TextDecorations Classe

Definizione

Fornisce un set di decorazioni di testo statiche predefinite.

public ref class TextDecorations abstract sealed
public static class TextDecorations
type TextDecorations = class
Public Class TextDecorations
Ereditarietà
TextDecorations

Esempio

Nell'esempio seguente, una decorazione di testo barrato usa il valore predefinito del carattere.

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

È anche possibile specificare più decorazioni di testo per lo stesso testo. Nell'esempio seguente viene utilizzata una decorazione di testo sottolineatura e sovralinea per lo stesso testo.

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

È possibile utilizzare il valore stringa "None" per indicare che nella raccolta non sono presenti decorazioni di TextDecorations testo. Nell'esempio seguente la TextDecorations raccolta è impostata su "None".

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

È possibile rimuovere tutte le decorazioni di testo dal testo usando il Clear metodo . Nell'esempio seguente la TextDecorations raccolta viene cancellata.

TextBlock2.TextDecorations.Clear();
TextBlock2.TextDecorations.Clear()

Per impostazione predefinita, Hyperlink usa un TextDecoration oggetto per visualizzare una sottolineatura. L'esempio di markup seguente mostra un Hyperlink definito con e senza sottolineatura:

<!-- 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 gli oggetti possono richiedere un elevato utilizzo delle prestazioni per creare un'istanza, in particolare se si dispone di molti Hyperlink oggetti. Per altre informazioni, vedere Procedura: Specificare se un collegamento ipertestuale è sottolineato.

Commenti

Ci sono quattro tipi di decorazioni di testo: linea di base, sopralinea, barrato e sottolineatura. Nell'esempio seguente vengono illustrate le posizioni delle decorazioni di testo relative al testo.

Diagramma delle posizioni delle decorazioni del testo Diagramma Esempio di tipi di decorazione del testo

Utilizzo degli attributi XAML

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

Valori XAML

textDecorationType Tipo di decorazione del testo: Baseline, OverLine, Strikethrougho Underline. Sono consentite più decorazioni, con valori separati da virgole. È anche possibile specificare "Nessuno" per indicare nessun tipo di decorazione del testo.

Proprietà

Nome Descrizione
Baseline

Specifica una linea di base TextDecoration.

OverLine

Specifica un oggetto overline TextDecoration.

Strikethrough

Specifica un barrato TextDecoration.

Underline

Specifica una sottolineatura TextDecoration.

Si applica a