IXRTextBlock (Windows Embedded CE 6.0)

1/6/2010

This class provides a lightweight control for displaying small amounts of text content.

Syntax

class IXRTextBlock : public IXRFrameworkElement

Methods

Method	Description
IXRTextBlock::GetBackground	Retrieves a Brush that provides the background of this text block.
IXRTextBlock::GetFontFamily	Retrieves the preferred top-level font family for the text in this text block.
IXRTextBlock::GetFontSize	Retrieves the font size for the text in this text block.
IXRTextBlock::GetFontSource	Retrieves the font source that is applied to this text block for displaying content.
IXRTextBlock::GetFontStretch	Retrieves a value that indicates how much a font is condensed or expanded on-screen.
IXRTextBlock::GetFontStyle	Retrieves the font style for the text in this text block.
IXRTextBlock::GetFontWeight	Retrieves the top-level font weight for this text block.
IXRTextBlock::GetForeground	Retrieves the Brush that paints the text in this text block.
IXRTextBlock::GetHighlightBackground	Retrieves the Brush used to paint the background of highlighted text in this text block.
IXRTextBlock::GetHighlightForeground	Retrieves the Brush used to paint text that is highlighted in this text block.
IXRTextBlock::GetHighlights	Retrieves a value that specifies a set of characters to be highlighted.
IXRTextBlock::GetInlines	Retrieves the collection of inline text elements in this text block.
IXRTextBlock::GetLineHeight	Retrieves the height of each line of text in this text block.
IXRTextBlock::GetLineStackingStrategy	Retrieves a value that indicates how a line box is determined for each line of text in this text block.
IXRTextBlock::GetPadding	Retrieves a value that indicates the width of padding space between the boundaries of the content area and the content that is displayed by a text block.
IXRTextBlock::GetText	Retrieves the text contents of this text block.
IXRTextBlock::GetTextAlignment	Retrieves a value that indicates the horizontal alignment of text content inside this text block.
IXRTextBlock::GetTextWrapping	Retrieves how this text block wraps its text.
IXRTextBlock::SetBackground	Sets the Brush that provides the background of this text block.
IXRTextBlock::SetFontFamily	Sets the preferred top-level font family for the text in this text block.
IXRTextBlock::SetFontSize	Sets the font size for the text in this text block.
IXRTextBlock::SetFontSource	Sets the font source that is applied to this text block for displaying text content.
IXRTextBlock::SetFontStretch	Sets a value that indicates how much a font is condensed or expanded on-screen.
IXRTextBlock::SetFontStyle	Sets the font style for the text in this text block.
IXRTextBlock::SetFontWeight	Sets the top-level font weight for this text block.
IXRTextBlock::SetForeground	Sets the Brush to use to paint the text in this text block.
IXRTextBlock::SetHighlightBackground	Sets a Brush to use to paint the background of highlighted text in this text block.
IXRTextBlock::SetHighlightForeground	Sets the Brush to use to paint text that is highlighted in this text block.
IXRTextBlock::SetHighlights	Sets a value that specifies a set of characters to be highlighted.
IXRTextBlock::SetInlines	Sets the collection of inline text elements in this text block.
IXRTextBlock::SetLineHeight	Sets the height of each line of text in this text block.
IXRTextBlock::SetLineStackingStrategy	Sets a value that indicates how a line box is determined for each line of text in this text block.
IXRTextBlock::SetPadding	Sets a value that indicates the width of padding space between the boundaries of the content area and the content that is displayed by a text block.
IXRTextBlock::SetText	Sets the text contents of this text block.
IXRTextBlock::SetTextAlignment	Sets a value that indicates the horizontal alignment of text content inside this text block.
IXRTextBlock::SetTextWrapping	Sets how this text block wraps its text.

Remarks

The IXRTextBlock object is the primary element for displaying text in Silverlight–based applications.

Note

Leading or trailing white space is not preserved when you set the Text property by calling IXRTextBlock::SetText.

You can align the IXRTextBlock object within the layout of the window by using IXRTextBox::SetTextAlignment, and the inherited methods IXRFrameworkElement::SetVerticalAlignment and IXRFrameworkElement::SetHorizontalAlignment.

The IXRRun and IXRLineBreak objects in the visual tree represent the <Run> and <LineBreak> XAML elements, which are used to render formatted text. These XAML elements are parsed into objects at run time by Silverlight for Windows Embedded. The IXRRun object is a text element that represents a discrete section of formatted or unformatted text. The IXRLineBreak object represents an explicit new line in an IXRTextBlock. If these XAML elements are used to define inner text, the corresponding run-time objects can be accessed from the inlines collection that is retrieved by IXRTextBlock::GetInlines.

You can also define a text block in Microsoft Silverlight 2 XAML. For information about the differences between XAML in Silverlight for Windows Embedded and Silverlight 2, see Differences Between Silverlight for the Web and Silverlight for Windows Embedded. For more information about how to define this element in the source XAML for your application, see this Microsoft Web site.

When you set text in a XAML <TextBlock> element instead of by using IXRTextBlock, it is not necessary in XAML to explicitly specify the Text property. You can put text in the <TextBlock> element as its content, or inner text. For more information about how to set a text block in the source XAML for your application, see the Microsoft Silverlight 2 documentation.

Inheritance Hierarchy

IXRDependencyObject

    IXRUIElement

        IXRFrameworkElement

            IXRTextBlock

.NET Framework Equivalent

System.Windows.Controls.TextBlock

Requirements

Header	XamlRuntime.h
sysgen	SYSGEN_XAML_RUNTIME
Windows Embedded CE	Windows Embedded CE 6.0 R3

See Also

Reference

Classes for UI Element Management

Other Resources