Illustrator29
InDesign2026 InDesign Server2025 Illustrator29 PhotoshopCC 2015.5 Bridge2021 Core JavaScriptExtendScript only ScriptUIExtendScript only
Collection

TextRange

A range of characters from a text item.

Properties

NameType AccessDescription
CharacterAttributes readonly The character properties for the text range.
Int32 read/write Offset of the first character of the range from the beginning of the story, in characters.
CharacterStyles<CharacterStyle> readonly List of referenced character styles in the text range.
Characters<TextRange> readonly All the characters in this text range.
String read/write The text string.
Int32 read/write End index of the text range.
InsertionPoints<InsertionPoint> readonly All the insertion points in this text range.
Int32 read/write Controls the spacing between two characters (in milli-ems)
Int32 0– read/write Length of text range.
Lines<TextRange> readonly All the lines in this text range.
ParagraphAttributes readonly The paragraph properties for the text range.
ParagraphStyles<ParagraphStyle> readonly List of referenced paragraph styles in the text range.
Paragraphs<TextRange> readonly All the paragraphs in this text range.
The readonly The object's container.
Int32 read/write Start index of the text range.
Story readonly The story of the text range.
TextRanges<TextRange> readonly All the text in this text range.
TextRange[] readonly The selected text (ranges) in the text range.
String readonly The class name of the object.
Words<TextRange> readonly All the words in this text range.

Methods

→ void

Change the capitalization of text.

type CaseChangeType The type of case.
→ void

Deselect the text range.

→ TextRange

Duplicate this object.

relativeObject Object
insertionLocation ElementPlacement
→ Int32

Get the length of the first paragraph.

→ Int32

Get the length of the first text run.

→ TextRange

Move the object.

relativeObject Object
insertionLocation ElementPlacement
→ void

Deletes this object.

→ void

Deletes all elements.

→ void

Select the text range.

addToDocument? Boolean Whether to add the text range to the document text selection.

Object of 5

Properties elsewhere that hold a TextRange.

Story.textRangeStory.textSelectionTextFrameItem.textRangeTextFrameItem.textSelectionTextRange.textSelection

Return 13

Methods that return a TextRange.

Characters.add()Characters.addBefore()Characters.getByName()Lines.getByName()Paragraphs.add()Paragraphs.addBefore()Paragraphs.getByName()TextRange.duplicate()TextRange.move()TextRanges.getByName()Words.add()Words.addBefore()Words.getByName()