TextDecorations Class

Definition

Stellt einen Satz von statischen vordefinierten Textdekorationen bereit.Provides a set of static predefined text decorations.

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

Examples

Im folgenden Beispiel wird für eine Text Dekoration mit durch Strichen der Standard Schriftart Wert verwendet.In the following example, a strikethrough text decoration uses the default font value.

// 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 Text Dekorationen für denselben Text angeben.You can also specify multiple text decorations for the same text. Im folgenden Beispiel werden eine Unterstreichung und eine über zeilige Text Dekoration für denselben Text verwendet.In the following example, an underline and overline text decoration are used for the same text.

<!-- 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 Zeichen folgen Wert "None" verwenden, um anzugeben, dass keine Text Dekorationen in der TextDecorations Auflistung vorhanden sind.You can use the string value "None" to indicate that there are no text decorations in the TextDecorations collection. Im folgenden Beispiel wird die TextDecorations Auflistung auf "None" festgelegt.In the following example, the TextDecorations collection is set to "None".

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

Sie können alle Text Dekorationen aus Text entfernen, indem Sie die Clear-Methode verwenden.You can remove all text decorations from text by using the Clear method. Im folgenden Beispiel wird die TextDecorations Auflistung gelöscht.In the following example, the TextDecorations collection is cleared.

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

Standardmäßig verwendet Hyperlink ein TextDecoration-Objekt, um einen Unterstrich anzuzeigen.By default, Hyperlink uses a TextDecoration object to display an underline. Das folgende Markup Beispiel zeigt eine Hyperlink, die mit und ohne Unterstreichung definiert ist: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>

TextDecoration Objekte können für die instanziieren sehr Leistungs intensiv sein, insbesondere wenn Sie über viele Hyperlink Objekte verfügen.TextDecoration objects can be performance intensive to instantiate, particularly if you have many Hyperlink objects. Weitere Informationen finden Sie unter Gewusst wie: angeben, ob ein Hyperlink unterstrichen ist.For more information, see How to: Specify Whether a Hyperlink is Underlined.

Remarks

Es gibt vier Arten von Text Dekorationen: Baseline, Overline, StrikeThrough und Unterstreichung.There are four types of text decorations: baseline, overline, strikethrough, and underline. Im folgenden Beispiel werden die Positionen der Text Dekorationen relativ zum Text dargestellt.The following example shows the locations of the text decorations relative to the text.

Diagramm der Orte für die Text DekorationDiagram of text decoration locations
Beispiel für Text Dekorations TypenExample of text decoration types

Verwendung von XAML-AttributenXAML Attribute Usage

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

XAML-WerteXAML Values

textDecorationType
Der Typ der Text Dekoration: Baseline, OverLine, Strikethroughoder Underline.The type of text decoration: Baseline, OverLine, Strikethrough, or Underline. Mehr als eine Dekoration ist zulässig, wobei die Werte durch Kommas getrennt sind.More than one decoration is permitted, with values separated by commas. Sie können auch "None" angeben, um keine Art von Text Dekoration anzugeben.You can also specify "None" to indicate no type of text decoration.

Properties

Baseline

Gibt die TextDecoration für eine Baseline an.Specifies a baseline TextDecoration.

OverLine

Gibt eine TextDecoration für eine Überstreichung an.Specifies an overline TextDecoration.

Strikethrough

Gibt eine TextDecoration für durchgestrichenen Text an.Specifies a strikethrough TextDecoration.

Underline

Gibt eine TextDecoration für eine Unterstreichung an.Specifies an underline TextDecoration.

Applies to