ITextRange Interface

Reference

Definition

Namespace:: Windows.UI.Text

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Represents a span of continuous text in a document, and provides powerful editing and data-binding properties and methods that allow an app to select, examine, and change document text.

public interface class ITextRange

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1537101399, 49266, 17056, 137, 69, 175, 80, 62, 229, 71, 104)]
struct ITextRange

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(1537101399, 49266, 17056, 137, 69, 175, 80, 62, 229, 71, 104)]
public interface ITextRange

Public Interface ITextRange

Derived: Windows.UI.Text.ITextSelection

Windows.UI.Text.RichEditTextRange

Attributes: ContractVersionAttribute GuidAttribute

Windows requirements

Device family	Windows 10 (introduced in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v1.0)

Properties

Character	Gets or sets the first character of the text range; that is, the character associated with the StartPosition property.
CharacterFormat	Gets or sets the character formatting attributes of the text range.
EndPosition	Gets or sets the end character position of the text range.
FormattedText	Gets or sets an ITextRange object with the formatted text of the specified range.
Gravity	Gets or sets the gravity of the text range.
Length	Gets the count of characters in the text range.
Link	Gets or sets the URL text associated with a text range.
ParagraphFormat	Gets or sets the paragraph formatting attributes of the text range.
StartPosition	Gets or sets the start position of the text range.
StoryLength	Gets the count of characters in the story of the text range.
Text	Gets or sets the plain text of the text range.

Methods

CanPaste(Int32)	Determines whether the Clipboard contains content that can be pasted, using a specified format, into the current text range.
ChangeCase(LetterCase)	Changes the case of letters in a text range.
Collapse(Boolean)	Collapses the text range into a degenerate point at either the beginning or end of the range.
Copy()	Copies the text of the text range to the Clipboard.
Cut()	Moves the text of the text range to the Clipboard.
Delete(TextRangeUnit, Int32)	Deletes text from the text range.
EndOf(TextRangeUnit, Boolean)	Moves or extends the text range to the end of the nearest specified text unit. The text range is moved or extended forward in the document.
Expand(TextRangeUnit)	Expands a text range to completely contain any partial text units.
FindText(String, Int32, FindOptions)	Searches for a particular text string in a range and, if found, selects the string.
GetCharacterUtf32(UInt32, Int32)	Retrieves the Unicode Transformation Format (UTF)-32 character code of the character at the specified offset from the end of the text range.
GetClone()	Creates a new object that is identical to this text range object.
GetIndex(TextRangeUnit)	Retrieves the story index of the text unit (word, line, sentence, paragraph, and so on) at the starting character position of the text range.
GetPoint(HorizontalCharacterAlignment, VerticalCharacterAlignment, PointOptions, Point)	Retrieves the screen coordinates of a particular location in the text range.
GetRect(PointOptions, Rect, Int32)	Retrieves the bounding rectangle that encompasses the text range on the screen.
GetText(TextGetOptions, String)	Retrieves the text in a text range according to the specified conversion flags.
GetTextViaStream(TextGetOptions, IRandomAccessStream)	Retrieves the text in the text range according to the specified conversion flags, as a random access stream.
InRange(ITextRange)	Determines whether this range is in or at the same text as a specified range.
InsertImage(Int32, Int32, Int32, VerticalCharacterAlignment, String, IRandomAccessStream)	Inserts an image into this range.
InStory(ITextRange)	Determines whether this range's story is the same as a specified range's story.
IsEqual(ITextRange)	Determines whether this range has the same character positions and story as those of a specified range.
MatchSelection()	Sets the start and end positions of this range to match the active selection.
Move(TextRangeUnit, Int32)	Moves the insertion point forward or backward by the specified number of units. If the text range is nondegenerate, it is collapsed to an insertion point at the start or end position of the text range, depending on count, and then is moved.
MoveEnd(TextRangeUnit, Int32)	Moves the end position of the text range.
MoveStart(TextRangeUnit, Int32)	Moves the start position of a text range.
Paste(Int32)	Pastes text from the Clipboard into the text range.
ScrollIntoView(PointOptions)	Scrolls this text range into view.
SetIndex(TextRangeUnit, Int32, Boolean)	Moves the text range to the specified unit of the story.
SetPoint(Point, PointOptions, Boolean)	Changes the text range based on the specified point.
SetRange(Int32, Int32)	Sets the endpoints of the text range to the specified values.
SetText(TextSetOptions, String)	Replaces the text in the text range.
SetTextViaStream(TextSetOptions, IRandomAccessStream)	Sets the text in the text range based on the contents of a random access stream.
StartOf(TextRangeUnit, Boolean)	Moves or extends the text range to the start of the nearest specified text unit. The text range is moved or extended backward in the document.

Applies to

Share via