Windows Dev Center

TextRangeUnit enumeration

Specifies the units to use when navigating a text range.


var value = Windows.UI.Text.TextRangeUnit.character;


The TextRangeUnit enumeration has these members.

Character | character0

A single character.

Word | word1

A span of alphanumeric characters, an end of paragraph, or punctuation that includes any blanks that follow.

Sentence | sentence2

A string of text that meets the following criteria:

  • Ends with a period, question mark, or exclamation mark.
  • Is followed by one or more ASCII white space characters (9 through 0xd and 0x20), or the Unicode paragraph separator (0x2029). The trailing white space is part of the sentence.
  • The last sentence in a story does not need to have a period, question mark, or exclamation mark.
  • Other sentences must follow a sentence end and cannot begin with a period, question mark, or exclamation mark.
  • The start of a story qualifies as the start of a Sentence, even if the string there doesn't qualify as a sentence grammatically.
Paragraph | paragraph3

A string of text terminated by an end-of-paragraph mark, such as CR/LF, carriage return (CR), vertical tab(VT), line feed (LF), form feed (FF), or the Unicode paragraph separator (0x2029).

Line | line4

A single line of text on a display, provided that the display is associated with the range. If no display is associated with a range, Line is treated as Paragraph. A selection automatically has a display.

Story | story5

A story, which is a contiguous range of text in a document. For example, a story can contain one of the various parts of a document, such as the main text of a document, headers and footers, footnotes, or annotations. In a rich edit control, there is only one story per document, although a client can use multiple documents to represent multiple stories.

Screen | screen6

The contents of a screen. Typically, a screen is the amount of content associated with the Page Up or Page Down key.

Section | section7

A section.

Window | window8

The characters between the upper-left and lower-right corners of the window.

CharacterFormat | characterFormat9

A text run of characters that all have identical character formatting properties.

ParagraphFormat | paragraphFormat10

A text run of characters that all have identical paragraph formatting properties.

Object | object11

An embedded object.

HardParagraph | hardParagraph12

A paragraph that is ended by a carriage return (CR) or CR/LF.

Cluster | cluster13

A complex-script cluster (occurs, for example, in Indic scripts).

Bold | bold14

Bold text.

Italic | italic15

Italic text.

Underline | underline16

Underlined text.

Strikethrough | strikethrough17

Strikethrough text.

ProtectedText | protectedText18

Protected text.

Link | link19

Hyperlink text.

SmallCaps | smallCaps20

Text in small caps.

AllCaps | allCaps21

Text in all uppercase.

Hidden | hidden22

Hidden text.

Outline | outline23

Outline text.

Shadow | shadow24

Shadow text.

Imprint | imprint25

Imprinted (engraved) text.

Disabled | disabled26

Disabled text.

Revised | revised27

Revised text.

Subscript | subscript28

Text in the subscript character format.

Superscript | superscript29

Text in the superscript character format.

FontBound | fontBound30

Text is in a font-bound font. That is, characters that can't be displayed with the current font were assigned a different font that could display the characters.

LinkProtected | linkProtected31

Characters in one or more contiguous, friendly-name hyperlinks. To work with single links that might be adjacent, use the Link unit.

Requirements (Windows 10 device family)

Device family


API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0


Windows::UI::Text [C++]



Requirements (Windows 8.x and Windows Phone 8.x)

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]


Windows::UI::Text [C++]





See also




© 2015 Microsoft