Export (0) Print
Expand All
2 out of 3 rated this helpful - Rate this topic

TextBlock.TextDecorations Property

Gets or sets a value that specifies the text decorations that are applied to the content in a TextBlock element.

Namespace:  System.Windows.Controls
Assembly:  System.Windows (in System.Windows.dll)
'Declaration
Public Property TextDecorations As TextDecorationCollection
<object TextDecorations="Underline"/>

Property Value

Type: System.Windows.TextDecorationCollection
A TextDecorationCollection, or Nothing if no text decorations are applied.

Dependency property identifier field: TextDecorationsProperty

A text decoration is a visual ornament that you can add to text. WPF supports APIs that let you define a custom text decoration. Silverlight 5 supports only one type of text decoration: Underline. The type name of type used to set this property (TextDecorationCollection) suggests multiple possible values, but only one value is supported. The name provides compatibility between Silverlight and WPF. The TextDecorationCollection object in Silverlight supports only object. It does support Collection interface APIs or a public constructor..

In XAML, you can set TextDecorations to the value Underline or to an empty string (equivalent to no underline).

In code, you can set the value of TextBlock.TextDecorations to Underline or to Nothing. Setting the value to Nothing effectively restores the default value if it has been set to Underline in XAML or code previously .

TextDecorations settings for Run child elements override this top-level setting.

The following code example shows how you can use the TextDecorations property to underline the text in a TextBlock.


<Grid x:Name="LayoutRoot" Background="White">
    <TextBlock Height="33" HorizontalAlignment="Left" Margin="47,109,0,0" Name="MyTBl" Text="Using TextDecorations property to underline the text." VerticalAlignment="Top" Width="308" />
</Grid>



Private Sub SetUnderline()
    MyTBl.TextDecorations = TextDecorations.Underline
End Sub


Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.