Objects That Represent Text Content - Adobe 65010248 - Illustrator CS4 - PC Manual

C 2: The Illustrator Scripting Object Model
HAPTER
To create a specific kind of text frame, use the
JavaScript and VBScript
path text frames.
As in the Illustrator application, you can thread area or path text frames.
To thread existing text frames, use the
Threaded frames make a single
For information on creating or threading text frames, see the chapter in this manual for your scripting
language.
Text geometry
While the three kinds of text frames have common characteristics, like
type-specific qualities, as reflected in the
➤
An area text frame can have rows and columns, which you access through the
column count
➤
Path text has
begins and ends.
➤
Area and path text frames are associated with a
text frame
orientation (horizontal or vertical) on the artboard (while the
property defines the orientation of text within the text frame).
The
text path
defined completely by the properties of the text frame itself.
N : A text path is not the same as a path art item. Text paths are associated with path art items that can
OTE
be accessed and manipulated to modify the appearance of the associated text frame.

Objects that represent text content

Within a text frame or story, the actual text content can be accessed as any of the following objects:
➤
characters
➤
words
➤
paragraphs
➤
lines
A object is all the characters that fit on one line in a
line
have at least one line of text, defined as a
contains hard line breaks or its characters flow to a new line because they do not fit in the width of the text
art. Text objects are accessed and identified by collections within the
example,
text frames
story
properties.
start T value
object's
text path
property is not valid for point text, because point-text position and orientation are
textFrame("My Text Frame").paragraphs
property of the
kind
objects contain specific methods for creating area text frames and
or
next frame previous frame
object.
object's properties. For example:
text frame
and properties that indicate where on the path the text
end T value
text path
property. The text path defines the text frame's position and
object. Text art can have multiple text lines, if the text
line
or
text frames
property of the
orientation
object, which is specified using the
object's
text frame
or object. All text-art items
text frame story
text frame
story("My Story").paragraphs
Text objects 22
object in AppleScript. The
object.
text frame
, each has
and
row count
orientation
and objects; for
story
.