InDesign2026
API 21.5.1.73
Object

TextPath

A text object that is on a path.

Properties

NameType AccessDescription
Number readonly The halfway point between the start bracket and the end bracket.
Characters<Character> readonly A collection of characters.
String | TextFrameContents | SpecialCharacters
read/write The contents of the text frame. Can return: String, TextFrameContents enumerator or SpecialCharacters enumerator.
Number read/write The end of the type on a path. Note: Additional text becomes overset text unless the text is linked to another path or text frame.
TextFrame | TextPath readonly The last text frame in the thread. Can return: TextFrame or TextPath.
EventListeners<EventListener> readonly A collection of event listeners.
Events<Event> readonly A collection of events.
FlipValues
read/write The flip effect applied to the type on a path.
Number readonly The unique ID of the TextPath.
Number readonly The index of the TextPath within its containing object.
InsertionPoints<InsertionPoint> readonly A collection of insertion points.
Boolean readonly Returns true if the object specifier resolves to valid objects.
String read/write A property that can be set to any string.
Lines<Line> readonly A collection of lines.
String read/write The name of the TextPath; this is an alias to the TextPath's label property.
NothingEnum | TextFrame | TextPath
read/write The next text frame in the thread. Can return: TextFrame or TextPath. Can also accept: NothingEnum enumerator.
Boolean readonly If true, the story has overset text.
Paragraphs<Paragraph> readonly A collection of paragraphs.
EndnoteTextFrame | GraphicLine | Oval | Polygon | Rectangle | TextFrame | EPSText | SplineItem readonly The parent of the TextPath (a SplineItem, Polygon, GraphicLine, Rectangle, Oval, TextFrame, EndnoteTextFrame or EPSText).
Story readonly The story that contains the text.
PathTypeAlignments
read/write The alignment of the type on a path.
TextPathEffects
read/write The effect applied to the type on a path.
Number read/write The spacing applied to the type on a path.
NothingEnum | TextFrame | TextPath
read/write The previous text frame in the thread. Can return: TextFrame or TextPath. Can also accept: NothingEnum enumerator.
Object read/write A property that allows setting of several properties at the same time.
Number read/write The location of the start of the type on the path, expressed in points. Note: 0 is the first point on the path.
TextFrame | TextPath readonly The first text frame in the thread. Can return: TextFrame or TextPath.
TextTypeAlignments
read/write The alignment applied to the type on a path.
TextColumns<TextColumn> readonly A collection of text columns.
Number readonly The index of the text frame within the story.
TextStyleRanges<TextStyleRange> readonly A collection of text style ranges.
Texts<Text> readonly A collection of text objects.
Words<Word> readonly A collection of words.

Events

NameDescription
Dispatched after a TextPath is placed. This event bubbles. This event is not cancelable.
Dispatched before a TextPath is placed. This event bubbles. This event is cancelable.

Methods

→ EventListener

Adds an event listener.

eventType String The event type.
handler File | JavaScriptFunction The event handler. Can accept: File or JavaScript Function.
captures? Boolean This parameter is obsolete.
→ Text[]

Finds glyphs that match the find what value and replaces the glyphs with the change to value.

reverseOrder? Boolean If true, returns the results in reverse order.
→ Text[]

Finds text that matches the find what value and replaces the text with the change to value.

reverseOrder? Boolean If true, returns the results in reverse order.
→ Text[]

Finds text that matches the find what value and replaces the text with the change to value.

reverseOrder? Boolean If true, returns the results in reverse order.
→ Text[]

Finds text that matches the find character type value and replaces the text with the change character type value.

reverseOrder? Boolean If true, returns the results in reverse order.
→ String

Gets the label value associated with the specified key.

key String The key.
→ Text[]

Finds glyphs that match the find what value.

reverseOrder? Boolean If true, returns the results in reverse order.
→ Text[]

Finds text that matches the find what value.

reverseOrder? Boolean If true, returns the results in reverse order.
→ Text[]

Finds text that matches the find what value.

reverseOrder? Boolean If true, returns the results in reverse order.
→ Text[]

Finds text that matches the find character type value.

reverseOrder? Boolean If true, returns the results in reverse order.
→ TextPath[]

Resolves the object specifier, creating an array of object references.

→ void

Sets the label to the value associated with the specified key.

key String The key.
value String The value.
→ void

Deletes the TextPath.

→ Boolean

Removes the event listener.

eventType String The registered event type.
handler File | JavaScriptFunction The registered event handler. Can accept: File or JavaScript Function.
captures? Boolean This parameter is obsolete.
→ String

Generates a string which, if executed, will return the TextPath.

→ String

Retrieves the object specifier.

Object of 23

Properties elsewhere that hold a TextPath.

Parameter of 3

Method parameters that accept a TextPath.

Return 14

Methods that return a TextPath.