TextBlock TextBlock TextBlock TextBlock Class

Definition

Provides a lightweight control for displaying small amounts of text.

public : sealed class TextBlock : FrameworkElement, ITextBlock, ITextBlock2, ITextBlock3, ITextBlock4, ITextBlock5
public sealed class TextBlock : FrameworkElement, ITextBlock, ITextBlock2, ITextBlock3, ITextBlock4, ITextBlock5
Public NotInheritable Class TextBlock Inherits FrameworkElement Implements ITextBlock, ITextBlock2, ITextBlock3, ITextBlock4, ITextBlock5
var textBlock = new textBlock();
<TextBlock ...>text</TextBlock>
-or-
<TextBlock>
  oneOrMoreInlineElements
</TextBlock>
-or-
<TextBlock .../>
Inheritance
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Examples

This example demonstrates a TextBlock with text selection enabled and text wrapping enabled.

The rendered text looks like this:

Text block with wrapped text

<TextBlock Text="This text demonstrates the wrapping behavior of a TextBlock." Width="240"
           IsTextSelectionEnabled="True" TextWrapping="Wrap"/>
TextBlock textBlock = new TextBlock();
textBlock.Text = "This text demonstrates the wrapping behavior of a TextBlock.";
textBlock.Width = 240;
textBlock.IsTextSelectionEnabled = true;
textBlock.TextWrapping = TextWrapping.Wrap;

// Add TextBlock to the visual tree.
rootPanel.Children.Add(textBlock);

This example shows how to customize the appearance of a TextBlock with a single Run of text. The FontWeight, FontFamily, FontStyle, Foreground color, and SelectionHighlightColor properties are customized.

The rendered text looks like this:

Text block with formatted text

<TextBlock Text="This text demonstrates some TextBlock properties." 
           IsTextSelectionEnabled="True" 
           SelectionHighlightColor="Green" 
           Foreground="Blue" 
           FontWeight="Light" 
           FontFamily="Arial" 
           FontStyle="Italic"/>
TextBlock textBlock = new TextBlock();
textBlock.Text = "This text demonstrates some TextBlock properties.";
textBlock.IsTextSelectionEnabled = true;
textBlock.SelectionHighlightColor = new SolidColorBrush(Windows.UI.Colors.Green);
textBlock.Foreground = new SolidColorBrush(Windows.UI.Colors.Blue);
textBlock.FontWeight = Windows.UI.Text.FontWeights.Light;
textBlock.FontFamily = new FontFamily("Arial");
textBlock.FontStyle = Windows.UI.Text.FontStyle.Italic;

// Add TextBlock to the visual tree.
rootPanel.Children.Add(textBlock);

This example demonstrates customizing different inline elements within a TextBlock.

The rendered text looks like this:

Text block with formatted inline elements

<TextBlock IsTextSelectionEnabled="True" SelectionHighlightColor="Green" FontFamily="Arial">
    <Run Foreground="Blue" FontWeight="Light" Text="This text demonstrates "></Run>
    <Span FontWeight="SemiBold">
        <Run FontStyle="Italic">the use of inlines </Run>
        <Run Foreground="Red">with formatting.</Run>
    </Span>
</TextBlock>
TextBlock textBlock = new TextBlock();
textBlock.IsTextSelectionEnabled = true;
textBlock.SelectionHighlightColor = new SolidColorBrush(Windows.UI.Colors.Green);
textBlock.FontFamily = new FontFamily("Arial");

// For Run and Span, add 'using Windows.UI.Xaml.Documents;'
Windows.UI.Xaml.Documents.Run run = new Run();
run.Foreground = new SolidColorBrush(Windows.UI.Colors.Blue);
run.FontWeight = Windows.UI.Text.FontWeights.Light;
run.Text = "This text demonstrates ";

Windows.UI.Xaml.Documents.Span span = new Span();
span.FontWeight = Windows.UI.Text.FontWeights.SemiBold;

Run run1 = new Run();
run1.FontStyle = Windows.UI.Text.FontStyle.Italic;
run1.Text = "the use of inlines ";

Run run2 = new Run();
run2.Foreground = new SolidColorBrush(Windows.UI.Colors.Red);
run2.Text = "with formatting.";

span.Inlines.Add(run1);
span.Inlines.Add(run2);
textBlock.Inlines.Add(run);
textBlock.Inlines.Add(span);

// Add TextBlock to the visual tree.
rootPanel.Children.Add(textBlock);

This example shows how to use an inline hyperlink. For more info, see Hyperlink.

<TextBlock><Hyperlink xml:space="preserve" NavigateUri="http://www.bing.com"> Hyperlink to Bing </Hyperlink></TextBlock>
//Create a TextBlock this is needed to put the hyperlink inside
TextBlock textBlock = new TextBlock();

// Create a Hyperlink and a Run. 
// The Run is used as the visible content of the hyperlink.
Hyperlink hyperlink = new Hyperlink();
Run run = new Run();

// Set the Text property on the run. 
// This is the visible text of the hyperlink.
run.Text = " Hyperlink to Bing ";

// Add the Run to the Hyperlink. 
hyperlink.Inlines.Add(run);

// Set the URI for the Hyperlink. 
hyperlink.NavigateUri = new Uri("http://www.bing.com");

// Add the Hyperlink to the TextBlock.
textBlock.Inlines.Add(hyperlink);

// Add TextBlock to the visual tree.        
rootPanel.Children.Add(textBlock);

The following example shows how to use the LineStackingStrategy property to determine how the line boxes are created for text lines of a TextBlock. The first TextBlock has a LineStackingStrategy value of MaxHeight,the second TextBlock has a value of BlockLineHeight, and the third TextBlock has a value of BaselineToBaseline.

The rendered text looks like this.

Text block line stacking strategies

<StackPanel>

<!-- This TextBlock has a LineStackingStrategy set to "MaxHeight". -->
<TextBlock FontFamily="Verdana"
           LineStackingStrategy="MaxHeight" 
           LineHeight="10" 
           Width="500" 
           TextWrapping="Wrap" >
    Use the <Run FontSize="30">LineStackingStrategy</Run> property to determine how a line box is
    created for each line. A value of <Run FontSize="20">MaxHeight</Run> specifies that the stack
    height is the smallest value that contains all the inline elements on that line when those
    elements are properly aligned. A value of <Run FontSize="20">BlockLineHeight</Run> specifies
    that the stack height is determined by the block element LineHeight property value. A value of 
    <Run FontSize="20">BaselineToBaseline</Run> specifies that the stack height is determined by adding 
    LineHeight to the baseline of the previous line.
</TextBlock>

<!-- With a margin pushing down 20 pixels, draw a line just above the second textblock. -->
<!-- The fonts will reach above the LineHeight size and over the line. -->
<StackPanel Margin="0,20,0,0" HorizontalAlignment="Center">
    <Line Stroke="Green"  X2="500" />
</StackPanel>

<!-- Here is the same TextBlock but the LineStackingStrategy is set to "BlockLineHeight". -->
<TextBlock FontFamily="Verdana"
           LineStackingStrategy="BlockLineHeight" 
           LineHeight="10" 
           Width="500" 
           TextWrapping="Wrap">
    Use the <Run FontSize="30">LineStackingStrategy</Run> property to determine how a line box is
    created for each line. A value of <Run FontSize="20">MaxHeight</Run> specifies that the stack
    height is the smallest value that contains all the inline elements on that line when those
    elements are properly aligned. A value of <Run FontSize="20">BlockLineHeight</Run> specifies
    that the stack height is determined by the block element LineHeight property value. A value of 
    <Run FontSize="20">BaselineToBaseline</Run> specifies that the stack height is determined by adding 
    LineHeight to the baseline of the previous line.
</TextBlock>

<!-- With a margin pushing down 20 pixels, draw a line just above the third textblock. -->
<StackPanel Margin="0,20,0,0" HorizontalAlignment="Center">
    <Line Stroke="Green"  X2="500" />
</StackPanel>

<!-- Here is the same TextBlock but the LineStackingStrategy is set to "BaselineToBaseline". -->
<TextBlock FontFamily="Verdana"
           LineStackingStrategy="BaselineToBaseline" 
           LineHeight="10" 
           Width="500" 
           TextWrapping="Wrap">
    Use the <Run FontSize="30">LineStackingStrategy</Run> property to determine how a line box is
    created for each line. A value of <Run FontSize="20">MaxHeight</Run> specifies that the stack
    height is the smallest value that contains all the inline elements on that line when those
    elements are properly aligned. A value of <Run FontSize="20">BlockLineHeight</Run> specifies
    that the stack height is determined by the block element LineHeight property value. A value of 
    <Run FontSize="20">BaselineToBaseline</Run> specifies that the stack height is determined by adding 
    LineHeight to the baseline of the previous line.
</TextBlock>

</StackPanel>

Remarks

TextBlock is the primary control for displaying read-only text in apps. You can use it to display single-line or multi-line text, inline hyperlinks, and text with formatting like bold, italic, or underlined.

Text block control

TextBlock is typically easier to use and provides better text rendering performance than RichTextBlock, so it's preferred for most app UI text. It also provides many of the same formatting options for customizing how your text is rendered. Although you can put line breaks in the text, TextBlock is designed to display a single paragraph and doesn’t support text indentation. Consider a RichTextBlock if you need support for multiple paragraphs, multi-column text, or inline UI elements like images.

For more info, see the TextBlock control guide.

Text performance

Starting in Windows 10, performance improvements were made to TextBlock that decrease overall memory use and greatly reduce the CPU time to do text measuring and arranging. To find out more about these performance improvements and how to make sure you are using them, see the Performance considerations section of the TextBlock control guide.

Built-in text styles

You can use Windows 10 text styles that ship with the platform to align the style of your text with the text used in the system. Here's how to use built-in styles to align with the Windows 10 type ramp. For more info, see XAML theme resources.

<TextBlock Text="Header" Style="{StaticResource HeaderTextBlockStyle}"/>
<TextBlock Text="SubHeader" Style="{StaticResource SubheaderTextBlockStyle}"/>
<TextBlock Text="Title" Style="{StaticResource TitleTextBlockStyle}"/>
<TextBlock Text="SubTitle" Style="{StaticResource SubtitleTextBlockStyle}"/>
<TextBlock Text="Base" Style="{StaticResource BaseTextBlockStyle}"/>
<TextBlock Text="Body" Style="{StaticResource BodyTextBlockStyle}"/>
<TextBlock Text="Caption" Style="{StaticResource CaptionTextBlockStyle}"/>

The rendered text looks like this:

Text block styles

Color fonts

By default TextBlock supports display color fonts. The default color font on the system is Segoe UI Emoji and the TextBlock will fall back to this font to display the glyphs in color. For more info, see the IsColorFontEnabled property.

<TextBlock FontSize="30">Hello ☺⛄☂♨⛅</TextBlock>

The rendered text looks like this:

Text block with color font

Constructors

TextBlock() TextBlock() TextBlock() TextBlock()

Initializes a new instance of the TextBlock class.

public : TextBlock()
public TextBlock()
Public Sub New()
var textBlock = new textBlock();

Properties

BaselineOffset BaselineOffset BaselineOffset BaselineOffset

Returns a value by which each line of text is offset from a baseline.

public : double BaselineOffset { get; }
public double BaselineOffset { get; }
Public ReadOnly Property BaselineOffset As double
var double = textBlock.baselineOffset;
Value
double double double double

The amount by which each line of text is offset from the baseline, in device independent pixels. System.Double.NaN indicates that an optimal baseline offset is automatically calculated from the current font characteristics. The default is System.Double.NaN.

Remarks

Note

Visual C++ component extensions (C++/CX) doesn't have a constant for NaN, it uses a value, which appears as "-1.#IND" followed by zeros.

CharacterSpacing CharacterSpacing CharacterSpacing CharacterSpacing

Gets or sets the uniform spacing between characters, in units of 1/1000 of an em.

public : int CharacterSpacing { get; set; }
public int CharacterSpacing { get; set; }
Public ReadWrite Property CharacterSpacing As int
var int = textBlock.characterSpacing;
textBlock.characterSpacing = int;
<TextBlock CharacterSpacing="int"/>
Value
int int int int

The uniform spacing between characters, in units of 1/1000 of an em. The default is 0. Positive values increase tracking and loosen character spacing. Negative values decrease tracking and tighten the character spacing.

CharacterSpacingProperty CharacterSpacingProperty CharacterSpacingProperty CharacterSpacingProperty

Identifies the CharacterSpacing dependency property.

public : static DependencyProperty CharacterSpacingProperty { get; }
public static DependencyProperty CharacterSpacingProperty { get; }
Public Static ReadOnly Property CharacterSpacingProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.characterSpacingProperty;

ContentEnd ContentEnd ContentEnd ContentEnd

Gets a TextPointer object for the end of text content in the TextBlock.

public : TextPointer ContentEnd { get; }
public TextPointer ContentEnd { get; }
Public ReadOnly Property ContentEnd As TextPointer
var textPointer = textBlock.contentEnd;
Value
TextPointer TextPointer TextPointer TextPointer

A TextPointer object for the end of text content in the TextBlock.

ContentStart ContentStart ContentStart ContentStart

Gets a TextPointer object for the start of text content in the TextBlock.

public : TextPointer ContentStart { get; }
public TextPointer ContentStart { get; }
Public ReadOnly Property ContentStart As TextPointer
var textPointer = textBlock.contentStart;
Value
TextPointer TextPointer TextPointer TextPointer

A TextPointer object for the start of text content in the TextBlock.

FontFamily FontFamily FontFamily FontFamily

Gets or sets the preferred top-level font family for the text content in this element.

public : FontFamily FontFamily { get; set; }
public FontFamily FontFamily { get; set; }
Public ReadWrite Property FontFamily As FontFamily
var fontFamily = textBlock.fontFamily;
textBlock.fontFamily = fontFamily;
<TextBlock FontFamily="fontFamily" />
-or-
<TextBlock FontFamily="fontFamilyName[,fallbackFontFamilyName]" />
-or-
<TextBlock FontFamily="fontURI#fontFamily" />
Value
FontFamily FontFamily FontFamily FontFamily

A FontFamily object that specifies the preferred font family, or a primary preferred font family with one or more fallback font families. For information about defaults, see the FontFamily class topic.

FontFamilyProperty FontFamilyProperty FontFamilyProperty FontFamilyProperty

Identifies the FontFamily dependency property.

public : static DependencyProperty FontFamilyProperty { get; }
public static DependencyProperty FontFamilyProperty { get; }
Public Static ReadOnly Property FontFamilyProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.fontFamilyProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the FontFamily dependency property.

FontSize FontSize FontSize FontSize

Gets or sets the font size for the text content in this element.

public : double FontSize { get; set; }
public double FontSize { get; set; }
Public ReadWrite Property FontSize As double
var double = textBlock.fontSize;
textBlock.fontSize = double;
<TextBlock FontSize="double" .../>
Value
double double double double

A non-negative value that specifies the font size, measured in pixels. The default is 11.

FontSizeProperty FontSizeProperty FontSizeProperty FontSizeProperty

Identifies the FontSize dependency property.

public : static DependencyProperty FontSizeProperty { get; }
public static DependencyProperty FontSizeProperty { get; }
Public Static ReadOnly Property FontSizeProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.fontSizeProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the FontSize dependency property.

FontStretch FontStretch FontStretch FontStretch

Gets or sets the font stretch for the text content in this element.

public : FontStretch FontStretch { get; set; }
public FontStretch FontStretch { get; set; }
Public ReadWrite Property FontStretch As FontStretch
var fontStretch = textBlock.fontStretch;
textBlock.fontStretch = fontStretch;
<TextBlock FontStretch="fontStretchMemberName"/>
Value
FontStretch FontStretch FontStretch FontStretch

The requested font stretch, as a FontStretch constant. The default is Normal.

FontStretchProperty FontStretchProperty FontStretchProperty FontStretchProperty

Identifies the FontStretch dependency property.

public : static DependencyProperty FontStretchProperty { get; }
public static DependencyProperty FontStretchProperty { get; }
Public Static ReadOnly Property FontStretchProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.fontStretchProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the FontStretch dependency property.

FontStyle FontStyle FontStyle FontStyle

Gets or sets the font style for the content in this element.

public : FontStyle FontStyle { get; set; }
public FontStyle FontStyle { get; set; }
Public ReadWrite Property FontStyle As FontStyle
var fontStyle = textBlock.fontStyle;
textBlock.fontStyle = fontStyle;
<TextBlock FontStyle="fontStyleMemberName"/>
Value
FontStyle FontStyle FontStyle FontStyle

The requested font style, which is a FontStyle enumeration value. The default is Normal.

FontStyleProperty FontStyleProperty FontStyleProperty FontStyleProperty

Identifies the FontStyle dependency property.

public : static DependencyProperty FontStyleProperty { get; }
public static DependencyProperty FontStyleProperty { get; }
Public Static ReadOnly Property FontStyleProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.fontStyleProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the FontStyle dependency property.

FontWeight FontWeight FontWeight FontWeight

Gets or sets the top-level font weight for the TextBlock.

public : FontWeight FontWeight { get; set; }
public FontWeight FontWeight { get; set; }
Public ReadWrite Property FontWeight As FontWeight
var fontWeight = textBlock.fontWeight;
textBlock.fontWeight = fontWeight;
<TextBlock FontWeight="fontWeightsMemberName"/>
Value
FontWeight FontWeight FontWeight FontWeight

The requested font weight, which is a FontWeight that is obtained from one of the FontWeights property values. The default is Normal.

FontWeightProperty FontWeightProperty FontWeightProperty FontWeightProperty

Identifies the FontWeight dependency property.

public : static DependencyProperty FontWeightProperty { get; }
public static DependencyProperty FontWeightProperty { get; }
Public Static ReadOnly Property FontWeightProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.fontWeightProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the FontWeight dependency property.

Foreground Foreground Foreground Foreground

Gets or sets the Brush to apply to the text contents of the TextBlock.

public : Brush Foreground { get; set; }
public Brush Foreground { get; set; }
Public ReadWrite Property Foreground As Brush
var brush = textBlock.foreground;
textBlock.foreground = brush;
<TextBlock Foreground="{StaticResource resourceName}"/>

Value
Brush Brush Brush Brush

The brush used to apply to the text content. The default is a null brush from a pure code perspective, but the default text styles set this to Black (for Light theme) or White (for Dark theme) for a TextBlock element in UI.

Examples

The following XAML example shows how to set the Foreground property to a solid color using an inline-defined attribute value "Maroon". The XAML parser uses this "Maroon" value to refer to the named color Colors.Maroon, and to create the SolidColorBrush instance that supplies the runtime value.

<TextBlock
  FontSize="32"
  FontWeight="Bold"
  Foreground="Maroon">
  Maroon
</TextBlock>

Remarks

TextBlock isn't a control so you don't use templates to change its appearance. Instead you can use styles. It's more common (and a better practice) to use named styles for TextBlock appearance than it is to set inline attributes for each TextBlock instance, particularly if you are using common values in many elements. For more info on styles, see Quickstart: Styling controls.

The default appearance of text and text styles depends heavily on the active theme and other settings. The theme and various styles and behaviors that are using default system settings or user preferences are the source of the effective runtime appearance of TextBlock foreground color of text as well as other text characteristics. You can change these defaults by changing the property values, or by applying a different style to specific TextBlock instances. You can change the foreground value for all default text by overriding the resource named DefaultTextForegroundThemeBrush in App.xaml.

See Also

ForegroundProperty ForegroundProperty ForegroundProperty ForegroundProperty

Identifies the Foreground dependency property.

public : static DependencyProperty ForegroundProperty { get; }
public static DependencyProperty ForegroundProperty { get; }
Public Static ReadOnly Property ForegroundProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.foregroundProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the Foreground dependency property.

HorizontalTextAlignment HorizontalTextAlignment HorizontalTextAlignment HorizontalTextAlignment

Gets or sets a value that indicates how text is aligned in the TextBlock.

public : TextAlignment HorizontalTextAlignment { get; set; }
public TextAlignment HorizontalTextAlignment { get; set; }
Public ReadWrite Property HorizontalTextAlignment As TextAlignment
var textAlignment = textBlock.horizontalTextAlignment;
textBlock.horizontalTextAlignment = textAlignment;
<TextBlock HorizontalTextAlignment="textAlignmentValue"/>

Value
TextAlignment TextAlignment TextAlignment TextAlignment

One of the TextAlignment enumeration values that specifies how text is aligned. The default is Left.

Additional features and requirements
Device family
Windows 10 Fall Creators Update (introduced v10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v5)

Remarks

This property provides the same functionality as the TextAlignment property. If both properties are set to conflicting values, the last one set is used.

Apps that target the Fall Creators Update (SDK 16299) or later should use this property instead of TextAlignment. If your app also supports previous versions, see Version adaptive apps: Use new APIs while maintaining compatibility with previous versions for more info.

HorizontalTextAlignmentProperty HorizontalTextAlignmentProperty HorizontalTextAlignmentProperty HorizontalTextAlignmentProperty

Identifies the HorizontalTextAlignment dependency property.

public : static DependencyProperty HorizontalTextAlignmentProperty { get; }
public static DependencyProperty HorizontalTextAlignmentProperty { get; }
Public Static ReadOnly Property HorizontalTextAlignmentProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.horizontalTextAlignmentProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the HorizontalTextAlignment dependency property.

Additional features and requirements
Device family
Windows 10 Fall Creators Update (introduced v10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v5)

Inlines Inlines Inlines Inlines

Gets the collection of inline text elements within a TextBlock.

public : InlineCollection Inlines { get; }
public InlineCollection Inlines { get; }
Public ReadOnly Property Inlines As InlineCollection
var inlineCollection = textBlock.inlines;
<TextBlock
  oneOrMoreInlineElements
</TextBlock>
Value
InlineCollection InlineCollection InlineCollection InlineCollection

A collection that holds all inline text elements from the TextBlock. The default is an empty collection.

IsColorFontEnabled IsColorFontEnabled IsColorFontEnabled IsColorFontEnabled

Gets or sets a value that determines whether font glyphs that contain color layers, such as Segoe UI Emoji, are rendered in color.

public : Platform::Boolean IsColorFontEnabled { get; set; }
public bool IsColorFontEnabled { get; set; }
Public ReadWrite Property IsColorFontEnabled As bool
var bool = textBlock.isColorFontEnabled;
textBlock.isColorFontEnabled = bool;
<TextBlock IsColorFontEnabled="bool" />
Value
Platform::Boolean bool bool bool

true if color glyphs show in color; otherwise, false. The default is true.

Remarks

Windows 8.1 introduces the ability for fonts to include multiple colored layers for each glyph. For example, the Segoe UI Emoji font defines color versions of the Emoticon and other Emoji characters. By default, the IsColorFontEnabled property is true and fonts with these additional layers are rendered in color.

In Windows 8, Extensible Application Markup Language (XAML) text controls don't render multi-color fonts in color. When an app that was compiled for Windows 8 is recompiled for Windows 8.1, color rendering of multi-color fonts is enabled by default. Some glyphs in multi-color fonts have different layout metrics when rendered in color. This could cause different layout in apps when they are recompiled for Windows 8.1. To retain the Windows 8 behavior when your app is recompiled for Windows 8.1, set IsColorFontEnabled to false.

IsColorFontEnabledProperty IsColorFontEnabledProperty IsColorFontEnabledProperty IsColorFontEnabledProperty

Identifies the IsColorFontEnabled dependency property.

public : static DependencyProperty IsColorFontEnabledProperty { get; }
public static DependencyProperty IsColorFontEnabledProperty { get; }
Public Static ReadOnly Property IsColorFontEnabledProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.isColorFontEnabledProperty;

IsTextScaleFactorEnabled IsTextScaleFactorEnabled IsTextScaleFactorEnabled IsTextScaleFactorEnabled

Gets or sets whether automatic text enlargement, to reflect the system text size setting, is enabled.

public : Platform::Boolean IsTextScaleFactorEnabled { get; set; }
public bool IsTextScaleFactorEnabled { get; set; }
Public ReadWrite Property IsTextScaleFactorEnabled As bool
var bool = textBlock.isTextScaleFactorEnabled;
textBlock.isTextScaleFactorEnabled = bool;
<TextBlock IsTextScaleFactorEnabled="bool"/>
Value
Platform::Boolean bool bool bool

true if automatic text enlargement is enabled; otherwise, false.

See Also

IsTextScaleFactorEnabledProperty IsTextScaleFactorEnabledProperty IsTextScaleFactorEnabledProperty IsTextScaleFactorEnabledProperty

Identifies the IsTextScaleFactorEnabled dependency property.

public : static DependencyProperty IsTextScaleFactorEnabledProperty { get; }
public static DependencyProperty IsTextScaleFactorEnabledProperty { get; }
Public Static ReadOnly Property IsTextScaleFactorEnabledProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.isTextScaleFactorEnabledProperty;

IsTextSelectionEnabled IsTextSelectionEnabled IsTextSelectionEnabled IsTextSelectionEnabled

Gets or sets a value that indicates whether text selection is enabled in the TextBlock, either through user action or calling selection-related API.

public : Platform::Boolean IsTextSelectionEnabled { get; set; }
public bool IsTextSelectionEnabled { get; set; }
Public ReadWrite Property IsTextSelectionEnabled As bool
var bool = textBlock.isTextSelectionEnabled;
textBlock.isTextSelectionEnabled = bool;
<TextBlock IsTextSelectionEnabled="bool" />
Value
Platform::Boolean bool bool bool

true if text selection is enabled; otherwise, false.

IsTextSelectionEnabledProperty IsTextSelectionEnabledProperty IsTextSelectionEnabledProperty IsTextSelectionEnabledProperty

Identifies the IsTextSelectionEnabled dependency property.

public : static DependencyProperty IsTextSelectionEnabledProperty { get; }
public static DependencyProperty IsTextSelectionEnabledProperty { get; }
Public Static ReadOnly Property IsTextSelectionEnabledProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.isTextSelectionEnabledProperty;

IsTextTrimmed IsTextTrimmed IsTextTrimmed IsTextTrimmed

Gets a value that indicates whether the control has trimmed text that overflows the content area.

public : Platform::Boolean IsTextTrimmed { get; }
public bool IsTextTrimmed { get; }
Public ReadOnly Property IsTextTrimmed As bool
var bool = textBlock.isTextTrimmed;
Value
Platform::Boolean bool bool bool

true if text is trimmed; otherwise, false.

Additional features and requirements
Device family
Windows 10 Fall Creators Update (introduced v10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v5)

Remarks

See the TextTrimming property and TextTrimming enumeration for more info about how text is trimmed.

IsTextTrimmedProperty IsTextTrimmedProperty IsTextTrimmedProperty IsTextTrimmedProperty

Identifies the IsTextTrimmed dependency property.

public : static DependencyProperty IsTextTrimmedProperty { get; }
public static DependencyProperty IsTextTrimmedProperty { get; }
Public Static ReadOnly Property IsTextTrimmedProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.isTextTrimmedProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the IsTextTrimmed dependency property.

Additional features and requirements
Device family
Windows 10 Fall Creators Update (introduced v10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v5)

LineHeight LineHeight LineHeight LineHeight

Gets or sets the height of each line of content.

public : double LineHeight { get; set; }
public double LineHeight { get; set; }
Public ReadWrite Property LineHeight As double
var double = textBlock.lineHeight;
textBlock.lineHeight = double;
<TextBlock LineHeight="double"/>
Value
double double double double

The height of each line in pixels. A value of 0 indicates that the line height is determined automatically from the current font characteristics. The default is 0.

LineHeightProperty LineHeightProperty LineHeightProperty LineHeightProperty

Identifies the LineHeight dependency property.

public : static DependencyProperty LineHeightProperty { get; }
public static DependencyProperty LineHeightProperty { get; }
Public Static ReadOnly Property LineHeightProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.lineHeightProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the LineHeight dependency property.

LineStackingStrategy LineStackingStrategy LineStackingStrategy LineStackingStrategy

Gets or sets a value that indicates how a line box is determined for each line of text in the TextBlock.

public : LineStackingStrategy LineStackingStrategy { get; set; }
public LineStackingStrategy LineStackingStrategy { get; set; }
Public ReadWrite Property LineStackingStrategy As LineStackingStrategy
var lineStackingStrategy = textBlock.lineStackingStrategy;
textBlock.lineStackingStrategy = lineStackingStrategy;
<TextBlock LineStackingStrategy="BlockLineHeight"/>
-or-
<TextBlock LineStackingStrategy="MaxHeight"/>
Value
LineStackingStrategy LineStackingStrategy LineStackingStrategy LineStackingStrategy

A value that indicates how a line box is determined for each line of text in the TextBlock. The default is MaxHeight.

LineStackingStrategyProperty LineStackingStrategyProperty LineStackingStrategyProperty LineStackingStrategyProperty

Identifies the LineStackingStrategy dependency property.

public : static DependencyProperty LineStackingStrategyProperty { get; }
public static DependencyProperty LineStackingStrategyProperty { get; }
Public Static ReadOnly Property LineStackingStrategyProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.lineStackingStrategyProperty;

MaxLines MaxLines MaxLines MaxLines

Gets or sets the maximum lines of text shown in the TextBlock.

public : int MaxLines { get; set; }
public int MaxLines { get; set; }
Public ReadWrite Property MaxLines As int
var int = textBlock.maxLines;
textBlock.maxLines = int;
<TextBlock MaxLines="int"/>
Value
int int int int

The maximum lines of text shown in the TextBlock. The default is 0, which is a special value that represents "Auto" behavior. The value cannot be negative.

Remarks

Use the MaxLines property to specify the maximum lines of text shown in a text block. The text control will adjust it’s height to show no more than the specified number of lines, regardless of the font size, font style, or text length.

Negative integer values are invalid, and will cause a run-time exception.

MaxLinesProperty MaxLinesProperty MaxLinesProperty MaxLinesProperty

Identifies the MaxLines dependency property.

public : static DependencyProperty MaxLinesProperty { get; }
public static DependencyProperty MaxLinesProperty { get; }
Public Static ReadOnly Property MaxLinesProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.maxLinesProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the MaxLines dependency property.

OpticalMarginAlignment OpticalMarginAlignment OpticalMarginAlignment OpticalMarginAlignment

Get or sets a value that indicates how the font is modified to align with fonts of different sizes.

public : OpticalMarginAlignment OpticalMarginAlignment { get; set; }
public OpticalMarginAlignment OpticalMarginAlignment { get; set; }
Public ReadWrite Property OpticalMarginAlignment As OpticalMarginAlignment
var opticalMarginAlignment = textBlock.opticalMarginAlignment;
textBlock.opticalMarginAlignment = opticalMarginAlignment;
<TextBlock OpticalMarginAlignment="None"/>
-or-
<TextBlock OpticalMarginAlignment="TrimSideBearings"/>
Value
OpticalMarginAlignment OpticalMarginAlignment OpticalMarginAlignment OpticalMarginAlignment

A value of the enumeration that indicates how the font is modified to align at different sizes. The default is None.

Remarks

When OpticalMarginAlignment is set to TrimSideBearings, the text is trimmed to the leftmost stroke of the first character and the rightmost stroke of the last character on a line. For example, an "L" has a small amount of space to the left of the vertical stroke, which scales with font size. When TrimSideBearings is set, the left of the vertical stroke is directly aligned without the spacing. This enables easier alignment to the Windows grid system as explained in Laying out an app page.

OpticalMarginAlignmentProperty OpticalMarginAlignmentProperty OpticalMarginAlignmentProperty OpticalMarginAlignmentProperty

Identifies the OpticalMarginAlignment dependency property.

public : static DependencyProperty OpticalMarginAlignmentProperty { get; }
public static DependencyProperty OpticalMarginAlignmentProperty { get; }
Public Static ReadOnly Property OpticalMarginAlignmentProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.opticalMarginAlignmentProperty;

Padding Padding Padding Padding

Gets or sets a value that indicates the thickness of padding space between the boundaries of the content area and the content displayed by a TextBlock.

public : Thickness Padding { get; set; }
public Thickness Padding { get; set; }
Public ReadWrite Property Padding As Thickness
var thickness = textBlock.padding;
textBlock.padding = thickness;
<TextBlock Padding="uniform"/>
- or -
<TextBlock Padding="left&Right,top&Bottom"/>
- or -
<TextBlock Padding="left,top,right,bottom"/>
Value
Thickness Thickness Thickness Thickness

A Thickness structure that specifies the amount of padding to apply.

Remarks

A related property is Margin (a property of FrameworkElement ). For more info about the relationship between margin and padding, see Alignment, margin, and padding or Define layouts with XAML.

See Also

PaddingProperty PaddingProperty PaddingProperty PaddingProperty

Identifies the Padding dependency property.

public : static DependencyProperty PaddingProperty { get; }
public static DependencyProperty PaddingProperty { get; }
Public Static ReadOnly Property PaddingProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.paddingProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the Padding dependency property.

SelectedText SelectedText SelectedText SelectedText

Gets a text range of selected text.

public : Platform::String SelectedText { get; }
public string SelectedText { get; }
Public ReadOnly Property SelectedText As string
var string = textBlock.selectedText;
Value
Platform::String string string string

A text range of the selected text.

SelectedTextProperty SelectedTextProperty SelectedTextProperty SelectedTextProperty

Identifies the SelectedText dependency property.

public : static DependencyProperty SelectedTextProperty { get; }
public static DependencyProperty SelectedTextProperty { get; }
Public Static ReadOnly Property SelectedTextProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.selectedTextProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the SelectedText dependency property.

SelectionEnd SelectionEnd SelectionEnd SelectionEnd

Gets the end position of the text selected in the TextBlock.

public : TextPointer SelectionEnd { get; }
public TextPointer SelectionEnd { get; }
Public ReadOnly Property SelectionEnd As TextPointer
var textPointer = textBlock.selectionEnd;
Value
TextPointer TextPointer TextPointer TextPointer

An object that represents the selection end, or null if no selection exists.

Remarks

Use Select to set the selection start and end.

SelectionHighlightColor SelectionHighlightColor SelectionHighlightColor SelectionHighlightColor

Gets or sets the brush used to highlight the selected text.

public : SolidColorBrush SelectionHighlightColor { get; set; }
public SolidColorBrush SelectionHighlightColor { get; set; }
Public ReadWrite Property SelectionHighlightColor As SolidColorBrush
var solidColorBrush = textBlock.selectionHighlightColor;
textBlock.selectionHighlightColor = solidColorBrush;
<TextBlock SelectionHighlightColor="{StaticResource resourceName}"/>

Value
SolidColorBrush SolidColorBrush SolidColorBrush SolidColorBrush

The brush used to highlight the selected text. The default is a null brush from a pure code perspective, but the system uses base text styles to supply a runtime value for apps (unless you specifically override that style). The practical default is a brush using the theme resource TextSelectionHighlightThemeColor.

See Also

SelectionHighlightColorProperty SelectionHighlightColorProperty SelectionHighlightColorProperty SelectionHighlightColorProperty

Identifies the SelectionHighlightColor dependency property.

public : static DependencyProperty SelectionHighlightColorProperty { get; }
public static DependencyProperty SelectionHighlightColorProperty { get; }
Public Static ReadOnly Property SelectionHighlightColorProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.selectionHighlightColorProperty;

SelectionStart SelectionStart SelectionStart SelectionStart

Gets the starting position of the text selected in the TextBlock.

public : TextPointer SelectionStart { get; }
public TextPointer SelectionStart { get; }
Public ReadOnly Property SelectionStart As TextPointer
var textPointer = textBlock.selectionStart;
Value
TextPointer TextPointer TextPointer TextPointer

An object that represents the selection start, or null if no selection exists.

Remarks

Use Select to set the selection start and end.

Text Text Text Text

Gets or sets the text contents of a TextBlock.

public : Platform::String Text { get; set; }
public string Text { get; set; }
Public ReadWrite Property Text As string
var string = textBlock.text;
textBlock.text = string;
<TextBlock Text="string"/>
Value
Platform::String string string string

A string that specifies the text contents of this TextBlock. The default is an empty string.

TextAlignment TextAlignment TextAlignment TextAlignment

Gets or sets a value that indicates the horizontal alignment of text content.

public : TextAlignment TextAlignment { get; set; }
public TextAlignment TextAlignment { get; set; }
Public ReadWrite Property TextAlignment As TextAlignment
var textAlignment = textBlock.textAlignment;
textBlock.textAlignment = textAlignment;
<TextBlock TextAlignment="textAlignmentMemberName"/>
Value
TextAlignment TextAlignment TextAlignment TextAlignment

The text alignment. The default is Left.

TextAlignmentProperty TextAlignmentProperty TextAlignmentProperty TextAlignmentProperty

Identifies the TextAlignment dependency property.

public : static DependencyProperty TextAlignmentProperty { get; }
public static DependencyProperty TextAlignmentProperty { get; }
Public Static ReadOnly Property TextAlignmentProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.textAlignmentProperty;

TextDecorations TextDecorations TextDecorations TextDecorations

Gets or sets a value that indicates what decorations are applied to the text.

public : TextDecorations TextDecorations { get; set; }
public TextDecorations TextDecorations { get; set; }
Public ReadWrite Property TextDecorations As TextDecorations
var textDecorations = textBlock.textDecorations;
textBlock.textDecorations = textDecorations;
<TextBlock TextDecorations="textDecorationsMemberName"/>
Value
TextDecorations TextDecorations TextDecorations TextDecorations

A value of the enumeration. The default is None.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

Examples

This example shows how to apply decorations to text.

<!-- Apply underline. -->
<TextBlock Text="Sample text" TextDecorations="Underline"/>

<!-- Apply underline and strikethrough. -->
<TextBlock Text="Sample text" TextDecorations="Underline, Strikethrough"/>

<!-- Apply decorations in code. -->
<TextBlock x:Name="TextBlock3" Text="Sample Text"
           Loaded="TextBlock_Loaded" />
private void TextBlock_Loaded(object sender, RoutedEventArgs e)
{
    // Apply both strikethough and underline to TextBlock3.
    TextBlock3.TextDecorations =
        TextDecorations.Strikethrough | TextDecorations.Underline;
}

Remarks

Starting with the Windows 10 Creators Update (SDK version 15063), this property is the preferred way to strikethrough or underline text.

For earlier versions of Windows, you can underline text with the Underline class.

TextDecorationsProperty TextDecorationsProperty TextDecorationsProperty TextDecorationsProperty

Identifies the TextDecorations dependency property.

public : static DependencyProperty TextDecorationsProperty { get; }
public static DependencyProperty TextDecorationsProperty { get; }
Public Static ReadOnly Property TextDecorationsProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.textDecorationsProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the TextDecorations dependency property.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

TextHighlighters TextHighlighters TextHighlighters TextHighlighters

Gets the collection of text highlights.

public : IVector<TextHighlighter> TextHighlighters { get; }
public IList<TextHighlighter> TextHighlighters { get; }
Public ReadOnly Property TextHighlighters As IList<TextHighlighter>
var iList = textBlock.textHighlighters;
Value
IVector<TextHighlighter> IList<TextHighlighter> IList<TextHighlighter> IList<TextHighlighter>

The collection of text highlights.

Additional features and requirements
Device family
Windows 10 Fall Creators Update (introduced v10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v5)

TextLineBounds TextLineBounds TextLineBounds TextLineBounds

Gets or sets a value that indicates how the line box height is determined for each line of text in the TextBlock.

public : TextLineBounds TextLineBounds { get; set; }
public TextLineBounds TextLineBounds { get; set; }
Public ReadWrite Property TextLineBounds As TextLineBounds
var textLineBounds = textBlock.textLineBounds;
textBlock.textLineBounds = textLineBounds;
<TextBlock TextLineBounds="textLineBoundsValue"/>
Value
TextLineBounds TextLineBounds TextLineBounds TextLineBounds

A value that indicates how the line box height is determined for each line of text in the TextBlock. The default is Full.

Remarks

For illustrations of how the different values for TextLineBounds affect adjacent lines of text, see TextLineBounds.

TextLineBoundsProperty TextLineBoundsProperty TextLineBoundsProperty TextLineBoundsProperty

Identifies the TextLineBounds dependency property.

public : static DependencyProperty TextLineBoundsProperty { get; }
public static DependencyProperty TextLineBoundsProperty { get; }
Public Static ReadOnly Property TextLineBoundsProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.textLineBoundsProperty;

TextProperty TextProperty TextProperty TextProperty

Identifies the Text dependency property.

public : static DependencyProperty TextProperty { get; }
public static DependencyProperty TextProperty { get; }
Public Static ReadOnly Property TextProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.textProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier of the Text dependency property.

TextReadingOrder TextReadingOrder TextReadingOrder TextReadingOrder

Gets or sets a value that indicates how the reading order is determined for the TextBlock.

public : TextReadingOrder TextReadingOrder { get; set; }
public TextReadingOrder TextReadingOrder { get; set; }
Public ReadWrite Property TextReadingOrder As TextReadingOrder
var textReadingOrder = textBlock.textReadingOrder;
textBlock.textReadingOrder = textReadingOrder;
<TextBlock TextReadingOrder="textReadingOrderValue"/>
Value
TextReadingOrder TextReadingOrder TextReadingOrder TextReadingOrder

A value that indicates how the reading order is determined for the TextBlock. The default is DetectFromContent.

Remarks

This property can be useful when the base direction of the text is unknown, and may not match the user's language or direction. For more info, see the Remarks section of the TextReadingOrder enumeration or How to support bidirectional UI.

Note

In Windows 8.1, the default value is 0, Default. Starting with Windows 10, the enumeration value 0 has the constant name UseFlowDirection, and is not the default value.

See Also

TextReadingOrderProperty TextReadingOrderProperty TextReadingOrderProperty TextReadingOrderProperty

Identifies the TextReadingOrder dependency property.

public : static DependencyProperty TextReadingOrderProperty { get; }
public static DependencyProperty TextReadingOrderProperty { get; }
Public Static ReadOnly Property TextReadingOrderProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.textReadingOrderProperty;

TextTrimming TextTrimming TextTrimming TextTrimming

Gets or sets the text trimming behavior to employ when content overflows the content area.

public : TextTrimming TextTrimming { get; set; }
public TextTrimming TextTrimming { get; set; }
Public ReadWrite Property TextTrimming As TextTrimming
var textTrimming = textBlock.textTrimming;
textBlock.textTrimming = textTrimming;
<TextBlock TextTrimming="None"/>
-or-
<TextBlock TextTrimming="WordEllipsis"/>
Value
TextTrimming TextTrimming TextTrimming TextTrimming

One of the TextTrimming values that specifies the text trimming behavior to employ. The default is None.

TextTrimmingProperty TextTrimmingProperty TextTrimmingProperty TextTrimmingProperty

Identifies the TextTrimming dependency property.

public : static DependencyProperty TextTrimmingProperty { get; }
public static DependencyProperty TextTrimmingProperty { get; }
Public Static ReadOnly Property TextTrimmingProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.textTrimmingProperty;

TextWrapping TextWrapping TextWrapping TextWrapping

Gets or sets how the TextBlock wraps text.

public : TextWrapping TextWrapping { get; set; }
public TextWrapping TextWrapping { get; set; }
Public ReadWrite Property TextWrapping As TextWrapping
var textWrapping = textBlock.textWrapping;
textBlock.textWrapping = textWrapping;
<TextBlock TextWrapping="Wrap"/>
-or-
<TextBlock TextWrapping="NoWrap"/>
Value
TextWrapping TextWrapping TextWrapping TextWrapping

A value that indicates how the TextBlock wraps text. The default is NoWrap.

TextWrappingProperty TextWrappingProperty TextWrappingProperty TextWrappingProperty

Identifies the TextWrapping dependency property.

public : static DependencyProperty TextWrappingProperty { get; }
public static DependencyProperty TextWrappingProperty { get; }
Public Static ReadOnly Property TextWrappingProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.TextBlock.textWrappingProperty;

AccessKey AccessKey AccessKey AccessKey

Inherited from UIElement

AccessKeyProperty AccessKeyProperty AccessKeyProperty AccessKeyProperty

Inherited from UIElement

AccessKeyScopeOwner AccessKeyScopeOwner AccessKeyScopeOwner AccessKeyScopeOwner

Inherited from UIElement

AccessKeyScopeOwnerProperty AccessKeyScopeOwnerProperty AccessKeyScopeOwnerProperty AccessKeyScopeOwnerProperty

Inherited from UIElement

ActualHeight ActualHeight ActualHeight ActualHeight

Inherited from FrameworkElement

ActualHeightProperty ActualHeightProperty ActualHeightProperty ActualHeightProperty

Inherited from FrameworkElement

ActualTheme ActualTheme ActualTheme ActualTheme

Inherited from FrameworkElement

ActualThemeProperty ActualThemeProperty ActualThemeProperty ActualThemeProperty

Inherited from FrameworkElement

ActualWidth ActualWidth ActualWidth ActualWidth

Inherited from FrameworkElement

ActualWidthProperty ActualWidthProperty ActualWidthProperty ActualWidthProperty

Inherited from FrameworkElement

AllowDrop AllowDrop AllowDrop AllowDrop

Inherited from UIElement

AllowDropProperty AllowDropProperty AllowDropProperty AllowDropProperty

Inherited from UIElement

AllowFocusOnInteraction AllowFocusOnInteraction AllowFocusOnInteraction AllowFocusOnInteraction

Inherited from FrameworkElement

AllowFocusOnInteractionProperty AllowFocusOnInteractionProperty AllowFocusOnInteractionProperty AllowFocusOnInteractionProperty

Inherited from FrameworkElement

AllowFocusWhenDisabled AllowFocusWhenDisabled AllowFocusWhenDisabled AllowFocusWhenDisabled

Inherited from FrameworkElement

AllowFocusWhenDisabledProperty AllowFocusWhenDisabledProperty AllowFocusWhenDisabledProperty AllowFocusWhenDisabledProperty

Inherited from FrameworkElement

BaseUri BaseUri BaseUri BaseUri

Inherited from FrameworkElement

CacheMode CacheMode CacheMode CacheMode

Inherited from UIElement

CacheModeProperty CacheModeProperty CacheModeProperty CacheModeProperty

Inherited from UIElement

CanDrag CanDrag CanDrag CanDrag

Inherited from UIElement

CanDragProperty CanDragProperty CanDragProperty CanDragProperty

Inherited from UIElement

CharacterReceivedEvent CharacterReceivedEvent CharacterReceivedEvent CharacterReceivedEvent

Inherited from UIElement

Clip Clip Clip Clip

Inherited from UIElement

ClipProperty ClipProperty ClipProperty ClipProperty

Inherited from UIElement

CompositeMode CompositeMode CompositeMode CompositeMode

Inherited from UIElement

CompositeModeProperty CompositeModeProperty CompositeModeProperty CompositeModeProperty

Inherited from UIElement

ContextFlyout ContextFlyout ContextFlyout ContextFlyout

Inherited from UIElement

ContextFlyoutProperty ContextFlyoutProperty ContextFlyoutProperty ContextFlyoutProperty

Inherited from UIElement

DataContext DataContext DataContext DataContext

Inherited from FrameworkElement

DataContextProperty DataContextProperty DataContextProperty DataContextProperty

Inherited from FrameworkElement

DesiredSize DesiredSize DesiredSize DesiredSize

Inherited from UIElement

Dispatcher Dispatcher Dispatcher Dispatcher

Inherited from DependencyObject

DoubleTappedEvent DoubleTappedEvent DoubleTappedEvent DoubleTappedEvent

Inherited from UIElement

DragEnterEvent DragEnterEvent DragEnterEvent DragEnterEvent

Inherited from UIElement

DragLeaveEvent DragLeaveEvent DragLeaveEvent DragLeaveEvent

Inherited from UIElement

DragOverEvent DragOverEvent DragOverEvent DragOverEvent

Inherited from UIElement

DropEvent DropEvent DropEvent DropEvent

Inherited from UIElement

ExitDisplayModeOnAccessKeyInvoked ExitDisplayModeOnAccessKeyInvoked ExitDisplayModeOnAccessKeyInvoked ExitDisplayModeOnAccessKeyInvoked

Inherited from UIElement

ExitDisplayModeOnAccessKeyInvokedProperty ExitDisplayModeOnAccessKeyInvokedProperty ExitDisplayModeOnAccessKeyInvokedProperty ExitDisplayModeOnAccessKeyInvokedProperty

Inherited from UIElement

FlowDirection FlowDirection FlowDirection FlowDirection

Inherited from FrameworkElement

FlowDirectionProperty FlowDirectionProperty FlowDirectionProperty FlowDirectionProperty

Inherited from FrameworkElement

FocusVisualMargin FocusVisualMargin FocusVisualMargin FocusVisualMargin

Inherited from FrameworkElement

FocusVisualMarginProperty FocusVisualMarginProperty FocusVisualMarginProperty FocusVisualMarginProperty

Inherited from FrameworkElement

FocusVisualPrimaryBrush FocusVisualPrimaryBrush FocusVisualPrimaryBrush FocusVisualPrimaryBrush

Inherited from FrameworkElement

FocusVisualPrimaryBrushProperty FocusVisualPrimaryBrushProperty FocusVisualPrimaryBrushProperty FocusVisualPrimaryBrushProperty

Inherited from FrameworkElement

FocusVisualPrimaryThickness FocusVisualPrimaryThickness FocusVisualPrimaryThickness FocusVisualPrimaryThickness

Inherited from FrameworkElement

FocusVisualPrimaryThicknessProperty FocusVisualPrimaryThicknessProperty FocusVisualPrimaryThicknessProperty FocusVisualPrimaryThicknessProperty

Inherited from FrameworkElement

FocusVisualSecondaryBrush FocusVisualSecondaryBrush FocusVisualSecondaryBrush FocusVisualSecondaryBrush

Inherited from FrameworkElement

FocusVisualSecondaryBrushProperty FocusVisualSecondaryBrushProperty FocusVisualSecondaryBrushProperty FocusVisualSecondaryBrushProperty

Inherited from FrameworkElement

FocusVisualSecondaryThickness FocusVisualSecondaryThickness FocusVisualSecondaryThickness FocusVisualSecondaryThickness

Inherited from FrameworkElement

FocusVisualSecondaryThicknessProperty FocusVisualSecondaryThicknessProperty FocusVisualSecondaryThicknessProperty FocusVisualSecondaryThicknessProperty

Inherited from FrameworkElement

GettingFocusEvent GettingFocusEvent GettingFocusEvent GettingFocusEvent

Inherited from UIElement

Height Height Height Height

Inherited from FrameworkElement

HeightProperty HeightProperty HeightProperty HeightProperty

Inherited from FrameworkElement

HighContrastAdjustment HighContrastAdjustment HighContrastAdjustment HighContrastAdjustment

Inherited from UIElement

HighContrastAdjustmentProperty HighContrastAdjustmentProperty HighContrastAdjustmentProperty HighContrastAdjustmentProperty

Inherited from UIElement

HoldingEvent HoldingEvent HoldingEvent HoldingEvent

Inherited from UIElement

HorizontalAlignment HorizontalAlignment HorizontalAlignment HorizontalAlignment

Inherited from FrameworkElement

HorizontalAlignmentProperty HorizontalAlignmentProperty HorizontalAlignmentProperty HorizontalAlignmentProperty

Inherited from FrameworkElement

IsAccessKeyScope IsAccessKeyScope IsAccessKeyScope IsAccessKeyScope

Inherited from UIElement

IsAccessKeyScopeProperty IsAccessKeyScopeProperty IsAccessKeyScopeProperty IsAccessKeyScopeProperty

Inherited from UIElement

IsDoubleTapEnabled IsDoubleTapEnabled IsDoubleTapEnabled IsDoubleTapEnabled

Inherited from UIElement

IsDoubleTapEnabledProperty IsDoubleTapEnabledProperty IsDoubleTapEnabledProperty IsDoubleTapEnabledProperty

Inherited from UIElement

IsHitTestVisible IsHitTestVisible IsHitTestVisible IsHitTestVisible

Inherited from UIElement

IsHitTestVisibleProperty IsHitTestVisibleProperty IsHitTestVisibleProperty IsHitTestVisibleProperty

Inherited from UIElement

IsHoldingEnabled IsHoldingEnabled IsHoldingEnabled IsHoldingEnabled

Inherited from UIElement

IsHoldingEnabledProperty IsHoldingEnabledProperty IsHoldingEnabledProperty IsHoldingEnabledProperty

Inherited from UIElement

IsRightTapEnabled IsRightTapEnabled IsRightTapEnabled IsRightTapEnabled

Inherited from UIElement

IsRightTapEnabledProperty IsRightTapEnabledProperty IsRightTapEnabledProperty IsRightTapEnabledProperty

Inherited from UIElement

IsTapEnabled IsTapEnabled IsTapEnabled IsTapEnabled

Inherited from UIElement

IsTapEnabledProperty IsTapEnabledProperty IsTapEnabledProperty IsTapEnabledProperty

Inherited from UIElement

KeyboardAccelerators KeyboardAccelerators KeyboardAccelerators KeyboardAccelerators

Inherited from UIElement

KeyDownEvent KeyDownEvent KeyDownEvent KeyDownEvent

Inherited from UIElement

KeyTipHorizontalOffset KeyTipHorizontalOffset KeyTipHorizontalOffset KeyTipHorizontalOffset

Inherited from UIElement

KeyTipHorizontalOffsetProperty KeyTipHorizontalOffsetProperty KeyTipHorizontalOffsetProperty KeyTipHorizontalOffsetProperty

Inherited from UIElement

KeyTipPlacementMode KeyTipPlacementMode KeyTipPlacementMode KeyTipPlacementMode

Inherited from UIElement

KeyTipPlacementModeProperty KeyTipPlacementModeProperty KeyTipPlacementModeProperty KeyTipPlacementModeProperty

Inherited from UIElement

KeyTipVerticalOffset KeyTipVerticalOffset KeyTipVerticalOffset KeyTipVerticalOffset

Inherited from UIElement

KeyTipVerticalOffsetProperty KeyTipVerticalOffsetProperty KeyTipVerticalOffsetProperty KeyTipVerticalOffsetProperty

Inherited from UIElement

KeyUpEvent KeyUpEvent KeyUpEvent KeyUpEvent

Inherited from UIElement

Language Language Language Language

Inherited from FrameworkElement

LanguageProperty LanguageProperty LanguageProperty LanguageProperty

Inherited from FrameworkElement

Lights Lights Lights Lights

Inherited from UIElement

LightsProperty LightsProperty LightsProperty LightsProperty

Inherited from UIElement

LosingFocusEvent LosingFocusEvent LosingFocusEvent LosingFocusEvent

Inherited from UIElement

ManipulationCompletedEvent ManipulationCompletedEvent ManipulationCompletedEvent ManipulationCompletedEvent

Inherited from UIElement

ManipulationDeltaEvent ManipulationDeltaEvent ManipulationDeltaEvent ManipulationDeltaEvent

Inherited from UIElement

ManipulationInertiaStartingEvent ManipulationInertiaStartingEvent ManipulationInertiaStartingEvent ManipulationInertiaStartingEvent

Inherited from UIElement

ManipulationMode ManipulationMode ManipulationMode ManipulationMode

Inherited from UIElement

ManipulationModeProperty ManipulationModeProperty ManipulationModeProperty ManipulationModeProperty

Inherited from UIElement

ManipulationStartedEvent ManipulationStartedEvent ManipulationStartedEvent ManipulationStartedEvent

Inherited from UIElement

ManipulationStartingEvent ManipulationStartingEvent ManipulationStartingEvent ManipulationStartingEvent

Inherited from UIElement

Margin Margin Margin Margin

Inherited from FrameworkElement

MarginProperty MarginProperty MarginProperty MarginProperty

Inherited from FrameworkElement

MaxHeight MaxHeight MaxHeight MaxHeight

Inherited from FrameworkElement

MaxHeightProperty MaxHeightProperty MaxHeightProperty MaxHeightProperty

Inherited from FrameworkElement

MaxWidth MaxWidth MaxWidth MaxWidth

Inherited from FrameworkElement

MaxWidthProperty MaxWidthProperty MaxWidthProperty MaxWidthProperty

Inherited from FrameworkElement

MinHeight MinHeight MinHeight MinHeight

Inherited from FrameworkElement

MinHeightProperty MinHeightProperty MinHeightProperty MinHeightProperty

Inherited from FrameworkElement

MinWidth MinWidth MinWidth MinWidth

Inherited from FrameworkElement

MinWidthProperty MinWidthProperty MinWidthProperty MinWidthProperty

Inherited from FrameworkElement

Name Name Name Name

Inherited from FrameworkElement

NameProperty NameProperty NameProperty NameProperty

Inherited from FrameworkElement

NoFocusCandidateFoundEvent NoFocusCandidateFoundEvent NoFocusCandidateFoundEvent NoFocusCandidateFoundEvent

Inherited from UIElement

Opacity Opacity Opacity Opacity

Inherited from UIElement

OpacityProperty OpacityProperty OpacityProperty OpacityProperty

Inherited from UIElement

Parent Parent Parent Parent

Inherited from FrameworkElement

PointerCanceledEvent PointerCanceledEvent PointerCanceledEvent PointerCanceledEvent

Inherited from UIElement

PointerCaptureLostEvent PointerCaptureLostEvent PointerCaptureLostEvent PointerCaptureLostEvent

Inherited from UIElement

PointerCaptures PointerCaptures PointerCaptures PointerCaptures

Inherited from UIElement

PointerCapturesProperty PointerCapturesProperty PointerCapturesProperty PointerCapturesProperty

Inherited from UIElement

PointerEnteredEvent PointerEnteredEvent PointerEnteredEvent PointerEnteredEvent

Inherited from UIElement

PointerExitedEvent PointerExitedEvent PointerExitedEvent PointerExitedEvent

Inherited from UIElement

PointerMovedEvent PointerMovedEvent PointerMovedEvent PointerMovedEvent

Inherited from UIElement

PointerPressedEvent PointerPressedEvent PointerPressedEvent PointerPressedEvent

Inherited from UIElement

PointerReleasedEvent PointerReleasedEvent PointerReleasedEvent PointerReleasedEvent

Inherited from UIElement

PointerWheelChangedEvent PointerWheelChangedEvent PointerWheelChangedEvent PointerWheelChangedEvent

Inherited from UIElement

PreviewKeyDownEvent PreviewKeyDownEvent PreviewKeyDownEvent PreviewKeyDownEvent

Inherited from UIElement

PreviewKeyUpEvent PreviewKeyUpEvent PreviewKeyUpEvent PreviewKeyUpEvent

Inherited from UIElement

Projection Projection Projection Projection

Inherited from UIElement

ProjectionProperty ProjectionProperty ProjectionProperty ProjectionProperty

Inherited from UIElement

RenderSize RenderSize RenderSize RenderSize

Inherited from UIElement

RenderTransform RenderTransform RenderTransform RenderTransform

Inherited from UIElement

RenderTransformOrigin RenderTransformOrigin RenderTransformOrigin RenderTransformOrigin

Inherited from UIElement

RenderTransformOriginProperty RenderTransformOriginProperty RenderTransformOriginProperty RenderTransformOriginProperty

Inherited from UIElement

RenderTransformProperty RenderTransformProperty RenderTransformProperty RenderTransformProperty

Inherited from UIElement

RequestedTheme RequestedTheme RequestedTheme RequestedTheme

Inherited from FrameworkElement

RequestedThemeProperty RequestedThemeProperty RequestedThemeProperty RequestedThemeProperty

Inherited from FrameworkElement

Resources Resources Resources Resources

Inherited from FrameworkElement

RightTappedEvent RightTappedEvent RightTappedEvent RightTappedEvent

Inherited from UIElement

Style Style Style Style

Inherited from FrameworkElement

StyleProperty StyleProperty StyleProperty StyleProperty

Inherited from FrameworkElement

TabFocusNavigation TabFocusNavigation TabFocusNavigation TabFocusNavigation

Inherited from UIElement

TabFocusNavigationProperty TabFocusNavigationProperty TabFocusNavigationProperty TabFocusNavigationProperty

Inherited from UIElement

Tag Tag Tag Tag

Inherited from FrameworkElement

TagProperty TagProperty TagProperty TagProperty

Inherited from FrameworkElement

TappedEvent TappedEvent TappedEvent TappedEvent

Inherited from UIElement

Transform3D Transform3D Transform3D Transform3D

Inherited from UIElement

Transform3DProperty Transform3DProperty Transform3DProperty Transform3DProperty

Inherited from UIElement

Transitions Transitions Transitions Transitions

Inherited from UIElement

TransitionsProperty TransitionsProperty TransitionsProperty TransitionsProperty

Inherited from UIElement

Triggers Triggers Triggers Triggers

Inherited from FrameworkElement

UseLayoutRounding UseLayoutRounding UseLayoutRounding UseLayoutRounding

Inherited from UIElement

UseLayoutRoundingProperty UseLayoutRoundingProperty UseLayoutRoundingProperty UseLayoutRoundingProperty

Inherited from UIElement

VerticalAlignment VerticalAlignment VerticalAlignment VerticalAlignment

Inherited from FrameworkElement

VerticalAlignmentProperty VerticalAlignmentProperty VerticalAlignmentProperty VerticalAlignmentProperty

Inherited from FrameworkElement

Visibility Visibility Visibility Visibility

Inherited from UIElement

VisibilityProperty VisibilityProperty VisibilityProperty VisibilityProperty

Inherited from UIElement

Width Width Width Width

Inherited from FrameworkElement

WidthProperty WidthProperty WidthProperty WidthProperty

Inherited from FrameworkElement

XYFocusDownNavigationStrategy XYFocusDownNavigationStrategy XYFocusDownNavigationStrategy XYFocusDownNavigationStrategy

Inherited from UIElement

XYFocusDownNavigationStrategyProperty XYFocusDownNavigationStrategyProperty XYFocusDownNavigationStrategyProperty XYFocusDownNavigationStrategyProperty

Inherited from UIElement

XYFocusKeyboardNavigation XYFocusKeyboardNavigation XYFocusKeyboardNavigation XYFocusKeyboardNavigation

Inherited from UIElement

XYFocusKeyboardNavigationProperty XYFocusKeyboardNavigationProperty XYFocusKeyboardNavigationProperty XYFocusKeyboardNavigationProperty

Inherited from UIElement

XYFocusLeftNavigationStrategy XYFocusLeftNavigationStrategy XYFocusLeftNavigationStrategy XYFocusLeftNavigationStrategy

Inherited from UIElement

XYFocusLeftNavigationStrategyProperty XYFocusLeftNavigationStrategyProperty XYFocusLeftNavigationStrategyProperty XYFocusLeftNavigationStrategyProperty

Inherited from UIElement

XYFocusRightNavigationStrategy XYFocusRightNavigationStrategy XYFocusRightNavigationStrategy XYFocusRightNavigationStrategy

Inherited from UIElement

XYFocusRightNavigationStrategyProperty XYFocusRightNavigationStrategyProperty XYFocusRightNavigationStrategyProperty XYFocusRightNavigationStrategyProperty

Inherited from UIElement

XYFocusUpNavigationStrategy XYFocusUpNavigationStrategy XYFocusUpNavigationStrategy XYFocusUpNavigationStrategy

Inherited from UIElement

XYFocusUpNavigationStrategyProperty XYFocusUpNavigationStrategyProperty XYFocusUpNavigationStrategyProperty XYFocusUpNavigationStrategyProperty

Inherited from UIElement

Methods

Focus(FocusState) Focus(FocusState) Focus(FocusState) Focus(FocusState)

Focuses the TextBlock, as if it were a conventionally focusable control.

public : Platform::Boolean Focus(FocusState value)
public bool Focus(FocusState value)
Public Function Focus(value As FocusState) As bool
var bool = textBlock.focus(value);
Parameters
value
FocusState FocusState FocusState FocusState

Specifies the desired target for focus state, as a value of the enumeration.

Returns
Platform::Boolean bool bool bool

true if focus was set to the TextBlock, or focus was already there. false if the TextBlock is not focusable.

Remarks

GetAlphaMask() GetAlphaMask() GetAlphaMask() GetAlphaMask()

Returns a mask that represents the alpha channel of the text as a CompositionBrush.

public : CompositionBrush GetAlphaMask()
public CompositionBrush GetAlphaMask()
Public Function GetAlphaMask() As CompositionBrush
var compositionBrush = textBlock.getAlphaMask();
Returns

A mask that represents the alpha channel of the text in a TextBlock.

Additional features and requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

Remarks

This method gets an alpha mask from the text as a CompositionBrush that you can use as an input to composition shadows and effects. The alpha mask CompositionBrush has the same alignment and stretch property values that the source XAML element applies to its rendered content so that you can use those values to correctly position shadows or effects relative to the XAML element.

Version compatibility

The GetAlphaMask method is not available prior to Windows 10, version 1607. If your app’s 'minimum platform version' setting in Microsoft Visual Studio is less than the 'introduced version' shown in the Requirements block later in this page, you must design and test your app to account for this. For more info, see Version adaptive code.

To avoid exceptions when your app runs on previous versions of Windows 10, do not call this method without first performing a runtime check. This example shows how to use the ApiInformation class to check for the presence of this method before you use it.

if (ApiInformation.IsMethodPresent("Windows.UI.Xaml.Controls.TextBlock", "GetAlphaMask"))
{
    var compositionBrush = textBlock1.GetAlphaMask();
}

Select(TextPointer, TextPointer) Select(TextPointer, TextPointer) Select(TextPointer, TextPointer) Select(TextPointer, TextPointer)

Selects a range of text in the TextBlock.

public : void Select(TextPointer start, TextPointer end)
public void Select(TextPointer start, TextPointer end)
Public Function Select(start As TextPointer, end As TextPointer) As void
textBlock.select(start, end);
Parameters
start
TextPointer TextPointer TextPointer TextPointer

An object that represents the start of the range to select.

end
TextPointer TextPointer TextPointer TextPointer

An object that represents the end of the range to select.

Remarks

In WPF and Silverlight the equivalent API uses integer for start and end positions. This implementation uses TextPointer objects to specify the selection.

SelectAll() SelectAll() SelectAll() SelectAll()

Selects the entire contents in the TextBlock.

public : void SelectAll()
public void SelectAll()
Public Function SelectAll() As void
textBlock.selectAll();

AddHandler(RoutedEvent,Object,Boolean) AddHandler(RoutedEvent,Object,Boolean) AddHandler(RoutedEvent,Object,Boolean) AddHandler(RoutedEvent,Object,Boolean)

Inherited from UIElement

Arrange(Rect) Arrange(Rect) Arrange(Rect) Arrange(Rect)

Inherited from UIElement

ArrangeOverride(Size) ArrangeOverride(Size) ArrangeOverride(Size) ArrangeOverride(Size)

Inherited from FrameworkElement

CancelDirectManipulations CancelDirectManipulations CancelDirectManipulations CancelDirectManipulations

Inherited from UIElement

CapturePointer(Pointer) CapturePointer(Pointer) CapturePointer(Pointer) CapturePointer(Pointer)

Inherited from UIElement

ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Inherited from DependencyObject

DeferTree(DependencyObject) DeferTree(DependencyObject) DeferTree(DependencyObject) DeferTree(DependencyObject)

Inherited from FrameworkElement

FindName(String) FindName(String) FindName(String) FindName(String)

Inherited from FrameworkElement

FindSubElementsForTouchTargeting(Point,Rect) FindSubElementsForTouchTargeting(Point,Rect) FindSubElementsForTouchTargeting(Point,Rect) FindSubElementsForTouchTargeting(Point,Rect)

Inherited from UIElement

GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty)

Inherited from DependencyObject

GetBindingExpression(DependencyProperty) GetBindingExpression(DependencyProperty) GetBindingExpression(DependencyProperty) GetBindingExpression(DependencyProperty)

Inherited from FrameworkElement

GetChildrenInTabFocusOrder GetChildrenInTabFocusOrder GetChildrenInTabFocusOrder GetChildrenInTabFocusOrder

Inherited from UIElement

GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Inherited from DependencyObject

GoToElementStateCore(String,Boolean) GoToElementStateCore(String,Boolean) GoToElementStateCore(String,Boolean) GoToElementStateCore(String,Boolean)

Inherited from FrameworkElement

InvalidateArrange InvalidateArrange InvalidateArrange InvalidateArrange

Inherited from UIElement

InvalidateMeasure InvalidateMeasure InvalidateMeasure InvalidateMeasure

Inherited from UIElement

Measure(Size) Measure(Size) Measure(Size) Measure(Size)

Inherited from UIElement

MeasureOverride(Size) MeasureOverride(Size) MeasureOverride(Size) MeasureOverride(Size)

Inherited from FrameworkElement

OnApplyTemplate OnApplyTemplate OnApplyTemplate OnApplyTemplate

Inherited from FrameworkElement

OnCreateAutomationPeer OnCreateAutomationPeer OnCreateAutomationPeer OnCreateAutomationPeer

Inherited from UIElement

OnDisconnectVisualChildren OnDisconnectVisualChildren OnDisconnectVisualChildren OnDisconnectVisualChildren

Inherited from UIElement

OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

Inherited from UIElement

ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Inherited from DependencyObject

RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback) RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback) RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback) RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback)

Inherited from DependencyObject

ReleasePointerCapture(Pointer) ReleasePointerCapture(Pointer) ReleasePointerCapture(Pointer) ReleasePointerCapture(Pointer)

Inherited from UIElement

ReleasePointerCaptures ReleasePointerCaptures ReleasePointerCaptures ReleasePointerCaptures

Inherited from UIElement

RemoveHandler(RoutedEvent,Object) RemoveHandler(RoutedEvent,Object) RemoveHandler(RoutedEvent,Object) RemoveHandler(RoutedEvent,Object)

Inherited from UIElement

SetBinding(DependencyProperty,BindingBase) SetBinding(DependencyProperty,BindingBase) SetBinding(DependencyProperty,BindingBase) SetBinding(DependencyProperty,BindingBase)

Inherited from FrameworkElement

SetValue(DependencyProperty,Object) SetValue(DependencyProperty,Object) SetValue(DependencyProperty,Object) SetValue(DependencyProperty,Object)

Inherited from DependencyObject

StartBringIntoView StartBringIntoView StartBringIntoView StartBringIntoView

Inherited from UIElement

StartBringIntoView(BringIntoViewOptions) StartBringIntoView(BringIntoViewOptions) StartBringIntoView(BringIntoViewOptions) StartBringIntoView(BringIntoViewOptions)

Inherited from UIElement

StartDragAsync(PointerPoint) StartDragAsync(PointerPoint) StartDragAsync(PointerPoint) StartDragAsync(PointerPoint)

Inherited from UIElement

TransformToVisual(UIElement) TransformToVisual(UIElement) TransformToVisual(UIElement) TransformToVisual(UIElement)

Inherited from UIElement

TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)

Inherited from UIElement

TryStartDirectManipulation(Pointer) TryStartDirectManipulation(Pointer) TryStartDirectManipulation(Pointer) TryStartDirectManipulation(Pointer)

Inherited from UIElement

UnregisterPropertyChangedCallback(DependencyProperty,Int64) UnregisterPropertyChangedCallback(DependencyProperty,Int64) UnregisterPropertyChangedCallback(DependencyProperty,Int64) UnregisterPropertyChangedCallback(DependencyProperty,Int64)

Inherited from DependencyObject

UpdateLayout UpdateLayout UpdateLayout UpdateLayout

Inherited from UIElement

Events

ContextMenuOpening ContextMenuOpening ContextMenuOpening ContextMenuOpening

Occurs when the system processes an interaction that displays a context menu.

public : event ContextMenuOpeningEventHandler ContextMenuOpening<>
public event ContextMenuOpeningEventHandler ContextMenuOpening<>
Public Event ContextMenuOpeningEventHandler ContextMenuOpening( Of )
function onContextMenuOpening(eventArgs){/* Your code */}


textBlock.addEventListener("contextMenuOpening", onContextMenuOpening);
textBlock.removeEventListener("contextMenuOpening", onContextMenuOpening);
<TextBlock ContextMenuOpening="eventhandler" />

IsTextTrimmedChanged IsTextTrimmedChanged IsTextTrimmedChanged IsTextTrimmedChanged

Occurs when the IsTextTrimmed property value has changed.

public : event TypedEventHandler IsTextTrimmedChanged<TextBlock,  IsTextTrimmedChangedEventArgs>
public event TypedEventHandler IsTextTrimmedChanged<TextBlock,  IsTextTrimmedChangedEventArgs>
Public Event TypedEventHandler IsTextTrimmedChanged( Of ( Of TextBlock ), ( Of  IsTextTrimmedChangedEventArgs ))
function onIsTextTrimmedChanged(eventArgs){/* Your code */}


textBlock.addEventListener("isTextTrimmedChanged", onIsTextTrimmedChanged);
textBlock.removeEventListener("isTextTrimmedChanged", onIsTextTrimmedChanged);
<TextBlock IsTextTrimmedChanged="eventhandler"/>

Additional features and requirements
Device family
Windows 10 Fall Creators Update (introduced v10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v5)

SelectionChanged SelectionChanged SelectionChanged SelectionChanged

Occurs when the text selection has changed.

public : event RoutedEventHandler SelectionChanged<>
public event RoutedEventHandler SelectionChanged<>
Public Event RoutedEventHandler SelectionChanged( Of )
function onSelectionChanged(eventArgs){/* Your code */}


textBlock.addEventListener("selectionChanged", onSelectionChanged);
textBlock.removeEventListener("selectionChanged", onSelectionChanged);
<TextBlock SelectionChanged="eventhandler"/>

AccessKeyDisplayDismissed AccessKeyDisplayDismissed AccessKeyDisplayDismissed AccessKeyDisplayDismissed

Inherited from UIElement

AccessKeyDisplayRequested AccessKeyDisplayRequested AccessKeyDisplayRequested AccessKeyDisplayRequested

Inherited from UIElement

AccessKeyInvoked AccessKeyInvoked AccessKeyInvoked AccessKeyInvoked

Inherited from UIElement

ActualThemeChanged ActualThemeChanged ActualThemeChanged ActualThemeChanged

Inherited from FrameworkElement

CharacterReceived CharacterReceived CharacterReceived CharacterReceived

Inherited from UIElement

ContextCanceled ContextCanceled ContextCanceled ContextCanceled

Inherited from UIElement

ContextRequested ContextRequested ContextRequested ContextRequested

Inherited from UIElement

DataContextChanged DataContextChanged DataContextChanged DataContextChanged

Inherited from FrameworkElement

DoubleTapped DoubleTapped DoubleTapped DoubleTapped

Inherited from UIElement

DragEnter DragEnter DragEnter DragEnter

Inherited from UIElement

DragLeave DragLeave DragLeave DragLeave

Inherited from UIElement

DragOver DragOver DragOver DragOver

Inherited from UIElement

DragStarting DragStarting DragStarting DragStarting

Inherited from UIElement

Drop Drop Drop Drop

Inherited from UIElement

DropCompleted DropCompleted DropCompleted DropCompleted

Inherited from UIElement

GettingFocus GettingFocus GettingFocus GettingFocus

Inherited from UIElement

GotFocus GotFocus GotFocus GotFocus

Inherited from UIElement

Holding Holding Holding Holding

Inherited from UIElement

KeyDown KeyDown KeyDown KeyDown

Inherited from UIElement

KeyUp KeyUp KeyUp KeyUp

Inherited from UIElement

LayoutUpdated LayoutUpdated LayoutUpdated LayoutUpdated

Inherited from FrameworkElement

Loaded Loaded Loaded Loaded

Inherited from FrameworkElement

Loading Loading Loading Loading

Inherited from FrameworkElement

LosingFocus LosingFocus LosingFocus LosingFocus

Inherited from UIElement

LostFocus LostFocus LostFocus LostFocus

Inherited from UIElement

ManipulationCompleted ManipulationCompleted ManipulationCompleted ManipulationCompleted

Inherited from UIElement

ManipulationDelta ManipulationDelta ManipulationDelta ManipulationDelta

Inherited from UIElement

ManipulationInertiaStarting ManipulationInertiaStarting ManipulationInertiaStarting ManipulationInertiaStarting

Inherited from UIElement

ManipulationStarted ManipulationStarted ManipulationStarted ManipulationStarted

Inherited from UIElement

ManipulationStarting ManipulationStarting ManipulationStarting ManipulationStarting

Inherited from UIElement

NoFocusCandidateFound NoFocusCandidateFound NoFocusCandidateFound NoFocusCandidateFound

Inherited from UIElement

PointerCanceled PointerCanceled PointerCanceled PointerCanceled

Inherited from UIElement

PointerCaptureLost PointerCaptureLost PointerCaptureLost PointerCaptureLost

Inherited from UIElement

PointerEntered PointerEntered PointerEntered PointerEntered

Inherited from UIElement

PointerExited PointerExited PointerExited PointerExited

Inherited from UIElement

PointerMoved PointerMoved PointerMoved PointerMoved

Inherited from UIElement

PointerPressed PointerPressed PointerPressed PointerPressed

Inherited from UIElement

PointerReleased PointerReleased PointerReleased PointerReleased

Inherited from UIElement

PointerWheelChanged PointerWheelChanged PointerWheelChanged PointerWheelChanged

Inherited from UIElement

PreviewKeyDown PreviewKeyDown PreviewKeyDown PreviewKeyDown

Inherited from UIElement

PreviewKeyUp PreviewKeyUp PreviewKeyUp PreviewKeyUp

Inherited from UIElement

ProcessKeyboardAccelerators ProcessKeyboardAccelerators ProcessKeyboardAccelerators ProcessKeyboardAccelerators

Inherited from UIElement

RightTapped RightTapped RightTapped RightTapped

Inherited from UIElement

SizeChanged SizeChanged SizeChanged SizeChanged

Inherited from FrameworkElement

Tapped Tapped Tapped Tapped

Inherited from UIElement

Unloaded Unloaded Unloaded Unloaded

Inherited from FrameworkElement

See Also