TextDecorations Classe

Definizione

Fornisce un insieme statico di decorazioni di testo 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 del carattere predefinito.

// 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 sopralinea 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 oggetto definito con e senza una 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

Esistono quattro tipi di decorazioni di testo: baseline, overline, 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

Uso della sintassi XAML per gli attributi

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

Valori XAML

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

Proprietà

Baseline

Specifica TextDecorationdi base.

OverLine

Specifica una linea sopra TextDecoration.

Strikethrough

Specifica una barratura TextDecoration.

Underline

Specifica una sottolineatura TextDecoration.

Si applica a