TextDecorations Class
Collapse the table of content
Expand the table of content

TextDecorations Class


Provides a set of static predefined text decorations.

Namespace:   System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)


public static class TextDecorations


Specifies a baseline TextDecoration.


Specifies an overline TextDecoration.


Specifies a strikethrough TextDecoration.


Specifies an underline TextDecoration.

There are four types of text decorations: baseline, overline, strikethrough, and underline. The following example shows the locations of the text decorations relative to the text.

Diagram of text decoration locations

Example of text decoration types

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


The type of text decoration: Baseline, OverLine, Strikethrough, or Underline. More than one decoration is permitted, with values separated by commas. You can also specify "None" to indicate no type of text decoration.

In the following example, a strikethrough text decoration uses the default font value.

You can also specify multiple text decorations for the same text. In the following example, an underline and overline text decoration are used for the same text.

You can use the string value "None" to indicate that there are no text decorations in the TextDecorations collection. In the following example, the TextDecorations collection is set to "None".

You can remove all text decorations from text by using the Clear method. In the following example, the TextDecorations collection is cleared.

By default, Hyperlink uses a TextDecoration object to display an underline. The following markup sample shows a Hyperlink defined with and without an underline:

TextDecoration objects can be performance intensive to instantiate, particularly if you have many Hyperlink objects. For more information, see How to: Specify Whether a Hyperlink is Underlined.

.NET Framework
Available since 3.0
Available since 2.0
Windows Phone Silverlight
Available since 7.0

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
© 2015 Microsoft