TextRun Class

.NET Framework (current version)

Represents a sequence of characters that share a single property set.

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

Inheritance Hierarchy

System::Object
System.Windows.Media.TextFormatting::TextRun
System.Windows.Media.TextFormatting::TextCharacters
System.Windows.Media.TextFormatting::TextEmbeddedObject
System.Windows.Media.TextFormatting::TextEndOfLine
System.Windows.Media.TextFormatting::TextEndOfSegment
System.Windows.Media.TextFormatting::TextHidden
System.Windows.Media.TextFormatting::TextModifier

Syntax

C++

public ref class TextRun abstract

Constructors

	Name	Description
	TextRun()	Creates an instance of a TextRun object.

Properties

	Name	Description
	CharacterBufferReference	Gets a reference to the text run character buffer.
	Length	Gets the number of characters in the text run.
	Properties	Gets the set of text properties that are shared by every character in the text run, such as typeface or foreground brush.

Methods

	Name	Description
	Equals(Object^)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	Finalize()	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	MemberwiseClone()	Creates a shallow copy of the current Object.(Inherited from Object.)
	ToString()	Returns a string that represents the current object.(Inherited from Object.)

A text run is a sequence of characters sharing a single property set. Any change to the format, such as font style, foreground color, font family, or any other formatting effect, breaks the text run. The following example illustrates how changes in formatting to a text string results in a series of text runs—each text run has a common set of formatting properties.

The TextRun class is the root of a type hierarchy representing several types of text content processed by TextFormatter. Each class that is derived from TextRun represents a distinct type of text content.

Class	Description
TextRun	Root of the hierarchy. Defines a group of characters that share the same set of character properties.
TextCharacters	Defines a collection of character glyphs from a distinct physical typeface.
TextEmbeddedObject	Defines a type of text content in which measuring, hit testing, and drawing of the entire content is done as a distinct entity. An example of this type of content is a button in the middle of the line of text.
TextEndOfLine	Defines a line-break character code.
TextEndOfParagraph	Defines a paragraph-break character code. Derives from TextEndOfLine.
TextEndOfSegment	Defines a segment break marker.
TextHidden	Defines a range of non-visible characters.
TextModifier	Defines the beginning of a modification scope.