TextRange

app.activeDocument.textFrames[index].textRange

Description

A range of text in a specific text art item. TextRange gives you access to the text contained in text art items.


Properties

TextRange.characterAttributes

app.activeDocument.textFrames[index].textRange.characterAttributes

Description

The character properties for the text range.

Type

CharacterAttributes, read-only.


TextRange.characterOffset

app.activeDocument.textFrames[index].textRange.characterOffset

Description

Offset of the first character.

Type

Number (long)


TextRange.characters

app.activeDocument.textFrames[index].textRange.characters

Description

All the characters in this text range.

Type

Characters, read-only.


TextRange.characterStyles

app.activeDocument.textFrames[index].textRange.characterStyles

Description

All referenced character styles in the text range.

Type

CharacterStyles, read-only.


TextRange.contents

app.activeDocument.textFrames[index].textRange.contents

Description

The text string.

Type

String


TextRange.end

app.activeDocument.textFrames[index].textRange.end

Description

End index of the text range.

Type

Int32


TextRange.insertionPoints

app.activeDocument.textFrames[index].textRange.insertionPoints

Description

All the insertion points in this text range.

Type

InsertionPoints, read-only.


TextRange.kerning

app.activeDocument.textFrames[index].textRange.kerning

Description

Controls the spacing between two characters, in thousandths of an em. An integer.

Type

Number (long)


TextRange.length

app.activeDocument.textFrames[index].textRange.length

Description

The length (in characters). Minimum: 0

Type

Number (long)


TextRange.lines

app.activeDocument.textFrames[index].textRange.lines

Description

All the lines in this text range.

Type

Lines, read-only.


TextRange.paragraphAttributes

app.activeDocument.textFrames[index].textRange.paragraphAttributes

Description

The paragraph properties for the text range.

Type

ParagraphAttributes, read-only.


TextRange.paragraphs

app.activeDocument.textFrames[index].textRange.paragraphs

Description

All the paragraphs in this text range.

Type

Paragraphs, read-only.


TextRange.paragraphStyles

app.activeDocument.textFrames[index].textRange.paragraphStyles

Description

All referenced paragraph styles in the text range.

Type

ParagraphStyles, read-only.


TextRange.parent

app.activeDocument.textFrames[index].textRange.parent

Description

The object’s container.

Type

TextRange, read-only.


TextRange.start

app.activeDocument.textFrames[index].textRange.start

Description

Start index of the text range.

Type

Int32


TextRange.story

app.activeDocument.textFrames[index].textRange.story

Description

The story to which the text range belongs.

Type

Story, read-only.


TextRange.textRanges

app.activeDocument.textFrames[index].textRange.textRanges

Description

All of the text in this text range.

Type

TextRanges, read-only.


TextRange.textSelection

app.activeDocument.textFrames[index].textRange.textSelection

Description

The selected text ranges in the text range.

Type

Array of TextRange, read-only.


TextRange.typename

app.activeDocument.textFrames[index].textRange.typename

Description

The class name of the object.

Type

String, read-only.


TextRange.words

app.activeDocument.textFrames[index].textRange.words

Description

All the words contained in this text range.

Type

Words, read-only.


Methods

TextRange.changeCaseTo()

app.activeDocument.textFrames[index].textRange.changeCaseTo(type)

Description

Changes the capitalization of text

Parameters

Parameter

Type

Description

type

CaseChangeType

Capitalization case to change to

Returns

Nothing


TextRange.deSelect()

app.activeDocument.textFrames[index].textRange.deSelect()

Description

Deselects the text range.

Returns

Nothing.


TextRange.duplicate()

app.activeDocument.textFrames[index].textRange.duplicate([relativeObject][, insertionLocation])

Description

Creates a duplicate of this object.

Parameters

Parameter

Type

Description

relativeObject

Object, optional

Object to duplicate to

insertionLocation

ElementPlacement, optional

Location to insert element

Returns

TextRange


TextRange.getLocalCharOverridesJSON()

app.activeDocument.textFrames[index].textRange.getLocalCharOverridesJSON()

Description

Gets json representation of character overrides.

Returns

String


TextRange.getLocalParaOverridesJSON()

app.activeDocument.textFrames[index].textRange.getLocalParaOverridesJSON()

Description

Gets json representation of paragraph overrides.

Returns

String


TextRange.getParagraphLength()

app.activeDocument.textFrames[index].textRange.getParagraphLength()

Description

Gets the length of the first paragraph of the text range.

Returns

Int32


TextRange.getTextRunLength()

app.activeDocument.textFrames[index].textRange.getTextRunLength()

Description

Gets the length of the first text run of the text range.

Returns

Int32


TextRange.move()

app.activeDocument.textFrames[index].textRange.move(relativeObject, insertionLocation)

Description

Moves the object.

Parameters

Parameter

Type

Description

relativeObject

Object

Object to move element within

insertionLocation

ElementPlacement, optional

Location to move element to

Returns

TextRange


TextRange.remove()

app.activeDocument.textFrames[index].textRange.remove()

Description

Deletes the object.

Returns

Nothing


TextRange.select()

app.activeDocument.textFrames[index].textRange.select([addToDocument])

Description

Selects the text range.

Parameters

Parameter

Type

Description

addToDocument

Boolean, optional

Whether to add or replace current selection

Returns

Nothing


Example

Manipulating Text

// Changes size of the first character of each word in the
// current document by changing the size attribute of each character

if ( app.documents.length > 0 ) {
  for ( i = 0; i < app.activeDocument.textFrames.length; i++ ) {
    var text = app.activeDocument.textFrames[i].textRange;
    for ( j = 0 ; j < text.words.length; j++ ) {
      //each word is a textRange object
      var textWord = text.words[j];

      // Characters are textRanges too.
      // Get the first character of each word and increase it's size.

      var firstChars = textWord.characters[0];
      firstChars.size = firstChars.size * 1.5;
    }
  }
}