TextDecorations Klasse

Definition

Stellt einen Satz von statischen vordefinierten Textdekorationen bereit.

public ref class TextDecorations abstract sealed
public static class TextDecorations
type TextDecorations = class
Public Class TextDecorations
Vererbung
TextDecorations

Beispiele

Im folgenden Beispiel verwendet eine durchgestrichene Textdekoration den Standardschriftartwert.

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

Sie können auch mehrere Textdekorationen für denselben Text angeben. Im folgenden Beispiel werden für denselben Text eine Unterstreichung und eine textübergreifende Textdekoration verwendet.

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

Sie können den Zeichenfolgenwert "None" verwenden, um anzugeben, dass in der TextDecorations Auflistung keine Textdekorationen vorhanden sind. Im folgenden Beispiel ist die TextDecorations Auflistung auf "None" festgelegt.

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

Sie können alle Textdekorationen aus Text entfernen, indem Sie die Clear -Methode verwenden. Im folgenden Beispiel wird die TextDecorations Auflistung gelöscht.

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

Standardmäßig verwendet Hyperlink ein TextDecoration-Objekt, um eine Unterstreichung anzuzeigen. Im folgenden Markupbeispiel wird ein mit und ohne Unterstreichung definierter Hyperlink gezeigt:

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

Das Instanziieren von TextDecoration-Objekten kann leistungsintensiv sein, insbesondere wenn Sie viele Hyperlink-Objekte haben. Weitere Informationen finden Sie unter Vorgehensweise: Angeben, ob ein Link unterstrichen ist.

Hinweise

Es gibt vier Arten von Textdekorationen: Baseline, Overline, Durchstreichen und Unterstrichen. Das folgende Beispiel zeigt die Position der Textdekorationen relativ zum Text.

Diagramm der Textdekorationsorte
Beispiel für Textdekorationstypen

Verwendung von XAML-Attributen

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

XAML-Werte

textDecorationType
Der Typ der Textdekoration: Baseline, OverLine, Strikethroughoder Underline. Mehr als eine Dekoration ist zulässig, wobei die Werte durch Kommas getrennt sind. Sie können auch "None" angeben, um keine Art von Textdekoration anzugeben.

Eigenschaften

Baseline

Gibt die TextDecoration für eine Baseline an.

OverLine

Gibt eine TextDecoration für eine Überstreichung an.

Strikethrough

Gibt eine TextDecoration für durchgestrichenen Text an.

Underline

Gibt eine TextDecoration für eine Unterstreichung an.

Gilt für: