Adobe InDesign CS4 (6.0) Object Model JS: Story

InDesign CS4

Class

Story

 

A story.

Superclass of XmlStory

QuickLinks

autoTag, changeGlyph, changeGrep, changeText, changecase, checkIn, checkOut, clearOverrides, convertBulletsAndNumberingToText, createOutlines, duplicate, exportFile, extractLabel, findGlyph, findGrep, findText, getElements, insertLabel, markup, move, placeXML, recompose, remove, revert, storyEdit, toSource, toSpecifier

Hierarchy

Document | XMLElement
Story
XmlStory
Bullet | Button | Change | Character | Footnote | FormField | HiddenText | InCopyExportOption | InsertionPoint | Line | Link | NestedGrepStyle | NestedLineStyle | NestedStyle | Note | NumberingRestartPolicy | PageItem | Paragraph | StoryPreference | TabStop | Table | Text | TextColumn | TextStyleRange | TextVariableInstance | Word

Properties

PropertyTypeAccessDescription
alignToBaselinebool r/wIf true, aligns the baseline of the text to the baseline grid.
allGraphicsArray of Graphic readonlyLists all graphics contained by the Story.
allPageItemsArray of PageItem readonlyLists all page items contained by the Story.
appliedCharacterStyleCharacterStyleString r/wThe character style applied to the text. Can also accept: String.
appliedFontFont
String
r/wThe font applied to the text, specified as either a font object or the name of font family. Can return: Font or String.
appliedLanguageLanguage
LanguageWithVendors
String
r/wThe language of the text. Can return: LanguageWithVendors or Language. Can also accept: String.
appliedNestedStylesArray of CharacterStyle readonlyThe applied character styles dictated by nested styles.
appliedNumberingListNumberingList
String
r/wThe list to be part of. Can return: NumberingList or String.
appliedParagraphStyleParagraphStyle
String
r/wThe paragraph style applied to the text. Can also accept: String.
associatedXMLElementXMLItem readonlyThe XML element associated with the Story.
autoLeadingnumber r/wThe percent of the type size to use for auto leading. (Range: 0 to 500).
balanceRaggedLinesBalanceLinesStyle
Boolean
r/wIf true or set to an enumeration value, balances ragged lines. Note: Not valid with a single-line text composer. Can return: Boolean or BalanceLinesStyle enumerator.
baselineShiftMeasurement Unit (Number or String) r/wThe baseline shift applied to the text.
bulletCharBullet readonlyBullet character.
bulletsAlignmentListAlignment:
ListAlignment.LEFT_ALIGN
ListAlignment.CENTER_ALIGN
ListAlignment.RIGHT_ALIGN
r/wThe alignment of the bullet character.
bulletsAndNumberingListTypeListType:
ListType.NO_LIST
ListType.BULLET_LIST
ListType.NUMBERED_LIST
r/wList type for bullets and numbering.
bulletsCharacterStyleCharacterStyle
String
r/wThe character style to be used for the text after string. Can return: CharacterStyle or String.
bulletsTextAfterstring r/wThe text after string expression for bullets.
buttonsButtons readonlyA collection of buttons.
capitalizationCapitalization:
Capitalization.NORMAL
Capitalization.SMALL_CAPS
Capitalization.ALL_CAPS
Capitalization.CAP_TO_SMALL_CAP
r/wThe capitalization scheme.
changesChanges readonlyA collection of changes.
characterDirectionCharacterDirectionOptions:
CharacterDirectionOptions.DEFAULT_DIRECTION
CharacterDirectionOptions.LEFT_TO_RIGHT_DIRECTION
CharacterDirectionOptions.RIGHT_TO_LEFT_DIRECTION
r/wThe direction of the character.
charactersCharacters readonlyA collection of characters.
composerstring r/wThe text composer to use to compose the text.
contentsSpecialCharacters
String
r/wThe contents of the text. Can return: String or SpecialCharacters enumerator.
desiredGlyphScalingnumber r/wThe desired width (as a percentage) of individual characters. (Range: 50 to 200)
desiredLetterSpacingnumber r/wThe desired letter spacing, specified as a percentge of the built-in space between letters in the font. (Range: -100 to 500)
desiredWordSpacingnumber r/wThe desired word spacing, specified as a percentage of the font word space value. (Range: 0 to 1000)
diacriticPositionDiacriticPositionOptions:
DiacriticPositionOptions.DEFAULT_POSITION
DiacriticPositionOptions.LOOSE_POSITION
DiacriticPositionOptions.MEDIUM_POSITION
DiacriticPositionOptions.TIGHT_POSITION
DiacriticPositionOptions.OPENTYPE_POSITION
r/wPosition of diacriticical characters.
digitsTypeDigitsTypeOptions:
DigitsTypeOptions.DEFAULT_DIGITS
DigitsTypeOptions.ARABIC_DIGITS
DigitsTypeOptions.HINDI_DIGITS
DigitsTypeOptions.FARSI_DIGITS
DigitsTypeOptions.NATIVE_DIGITS
DigitsTypeOptions.FULL_FARSI_DIGITS
DigitsTypeOptions.THAI_DIGITS
DigitsTypeOptions.LAO_DIGITS
DigitsTypeOptions.DEVANAGARI_DIGITS
DigitsTypeOptions.BENGALI_DIGITS
DigitsTypeOptions.GURMUKHI_DIGITS
DigitsTypeOptions.GUJARATI_DIGITS
DigitsTypeOptions.ORIYA_DIGITS
DigitsTypeOptions.TAMIL_DIGITS
DigitsTypeOptions.TELUGU_DIGITS
DigitsTypeOptions.KANNADA_DIGITS
DigitsTypeOptions.MALAYALAM_DIGITS
DigitsTypeOptions.TIBETAN_DIGITS
DigitsTypeOptions.KHMER_DIGITS
DigitsTypeOptions.BURMESE_DIGITS
r/wThe digits type.
dropCapCharactersnumber (range: 0 - 150) r/wThe number of characters to drop cap.
dropCapLinesnumber (range: 0 - 25) r/wThe number of lines to drop cap.
dropCapStyleCharacterStyle
String
r/wThe character style to apply to the drop cap. Can also accept: String.
dropcapDetailnumber r/wDetails about the drop cap based on the glyph outlines. 1 = left side bearing. 2 = descenders. 0x100,0x200,0x400 are used for Japanese frame grid.
endJoinOutlineJoin:
OutlineJoin.MITER_END_JOIN
OutlineJoin.ROUND_END_JOIN
OutlineJoin.BEVEL_END_JOIN
r/wThe stroke join type applied to the characters of the text.
fillColorString
Swatch
r/wThe swatch (color, gradient, tint, or mixed ink) applied to the fill of the text. . Can also accept: String.
fillTintnumber r/wThe tint (as a percentage) of the fill color of the text. (To specify a tint percentage, use a number in the range of 0 to 100; to use the inherited or overridden value, use -1.)
firstLineIndentMeasurement Unit (Number or String) r/wThe amount to indent the first line.
fontStylestring r/wThe name of the font style.
footnotesFootnotes readonlyA collection of footnotes.
formFieldsFormFields readonlyA collection of form fields.
gradientFillAnglenumber r/wThe angle of a linear gradient applied to the fill of the text. (Range: -180 to 180)
gradientFillLengthnumber r/wThe length (for a linear gradient) or radius (for a radial gradient) applied to the fill of the text.
gradientFillStartArray of Measurement Unit (Number or String) r/wThe starting point (in page coordinates) of a gradient applied to the fill of the text, in the format [x, y].
gradientStrokeAnglenumber r/wThe angle of a linear gradient applied to the stroke of the text. (Range: -180 to 180)
gradientStrokeLengthnumber r/wThe length (for a linear gradient) or radius (for a radial gradient) applied to the stroke of the text.
gradientStrokeStartArray of Measurement Unit (Number or String) r/wThe starting point (in page coordinates) of a gradient applied to the stroke of the text, in the format [x, y].
graphicLinesGraphicLines readonlyA collection of graphic lines.
gridAlignFirstLineOnlybool r/wIf true, aligns only the first line to the frame grid or baseline grid. If false, aligns all lines to the grid.
groupsGroups readonlyA collection of groups.
hiddenTextsHiddenTexts readonlyA collection of hidden text objects.
horizontalScalenumber r/wThe horizontal scaling applied to the text as a percentage of its current size. (Range: 1 to 1000)
hyphenWeightnumber (range: 0 - 10) r/wThe relative desirability of better spacing vs. fewer hyphens. A lower value results in greater use of hyphens. (Range: 0 to 100)
hyphenateAcrossColumnsbool r/wIf true, allows the last word in a text column to be hyphenated.
hyphenateAfterFirstnumber (range: 1 - 15) r/wThe mininum number of letters at the beginning of a word that can be broken by a hyphen.
hyphenateBeforeLastnumber (range: 1 - 15) r/wThe minimum number of letters at the end of a word that can be broken by a hyphen.
hyphenateCapitalizedWordsbool r/wIf true, allows hyphenation of capitalized words.
hyphenateLadderLimitnumber (range: 0 - 25) r/wThe maximum number of hyphens that can appear on consecutive lines. To specify unlimited consecutive lines, use zero.
hyphenateLastWordbool r/wIf true, allows hyphenation in the last word in a paragraph. Note: Valid only when hyphenation is true.
hyphenateWordsLongerThannumber (range: 3 - 25) r/wThe minimum number of letters a word must have in order to qualify for hyphenation.
hyphenationbool r/wIf true, allows hyphenation.
hyphenationZoneMeasurement Unit (Number or String) r/wThe amount of white space allowed at the end of a line of non-justified text before hypenation begins. Note: Valid when composer is single-line composer.
idnumber readonlyThe unique ID of the Story.
idmlComponentNamestring r/wThe IDML component name of the Story.
ignoreEdgeAlignmentbool r/wIf true, ignores optical edge alignment for the paragraph.
incopyExportOptionsInCopyExportOption readonlyExport options for InCopy INCX document format.
indexnumber readonlyThe index of the Story within its containing object.
insertionPointsInsertionPoints readonlyA collection of insertion points.
isValidbool readonlyReturns true if the object specifier resolves to valid objects.
itemLinkLink readonlyThe source file of the link.
justificationJustification:
Justification.LEFT_ALIGN
Justification.CENTER_ALIGN
Justification.RIGHT_ALIGN
Justification.LEFT_JUSTIFIED
Justification.RIGHT_JUSTIFIED
Justification.CENTER_JUSTIFIED
Justification.FULLY_JUSTIFIED
Justification.TO_BINDING_SIDE
Justification.AWAY_FROM_BINDING_SIDE
r/wThe paragraph alignment.
kashidasKashidasOptions:
KashidasOptions.DEFAULT_KASHIDAS
KashidasOptions.KASHIDAS_OFF
r/wUse of Kashidas for justification
keepAllLinesTogetherbool r/wIf true, keeps all lines of the paragraph together. If false, allows paragraphs to break across pages or columns.
keepFirstLinesnumber (range: 1 - 50) r/wThe minimum number of lines to keep together in a paragraph before allowing a page break.
keepLastLinesnumber (range: 1 - 50) r/wThe minimum number of lines to keep together in a paragraph after a page break.
keepLinesTogetherbool r/wIf true, keeps a specified number of lines together when the paragraph breaks across columns or text frames.
keepRuleAboveInFramebool r/wIf true, forces the rule above the paragraph to remain in the frame bounds. Note: Valid only when rule above is true.
keepWithNextnumber (range: 0 - 5) r/wThe minimum number of lines to keep with the next paragraph.
kerningMethodstring r/wThe type of pair kerning.
keyboardDirectionCharacterDirectionOptions:
CharacterDirectionOptions.DEFAULT_DIRECTION
CharacterDirectionOptions.LEFT_TO_RIGHT_DIRECTION
CharacterDirectionOptions.RIGHT_TO_LEFT_DIRECTION
r/wThe keyboard direction of the character.
labelstring r/wA property that can be set to any string.
lastLineIndentMeasurement Unit (Number or String) r/wThe amount to indent the last line in the paragraph.
leadingLeading
Unit
r/wThe leading applied to the text. Can return: Unit or Leading enumerator.
leftIndentMeasurement Unit (Number or String) r/wThe width of the left indent.
lengthnumber readonlyThe number of objects in the collection.
ligaturesbool r/wIf true, replaces specific character combinations (e.g., fl, fi) with ligature characters.
linesLines readonlyA collection of lines.
lockStateLockStateValues:
LockStateValues.NONE
LockStateValues.UNMANAGED_STORY
LockStateValues.CHECKED_IN_STORY
LockStateValues.CHECKED_OUT_STORY
LockStateValues.LOCKED_STORY
LockStateValues.EMBEDDED_STORY
LockStateValues.MISSING_LOCK_STATE
LockStateValues.MIXED_LOCK_STATE
readonlyThe lock state.
maximumGlyphScalingnumber r/wThe maximum width (as a percentage) of individual characters. (Range: 50 to 200)
maximumLetterSpacingnumber r/wThe maximum letter spacing, specified as a percentge of the built-in space between letters in the font. (Range: -100 to 500) Note: Valid only when text is justified.
maximumWordSpacingnumber r/wThe maximum word spacing, specified as a percentage of the font word space value. Note: Valid only when text is justified. (Range: 0 to 1000)
minimumGlyphScalingnumber r/wThe minimum width (as a percentage) of individual characters. (Range: 50 to 200)
minimumLetterSpacingnumber r/wThe minimum letter spacing, specified as a percentge of the built-in space between letters in the font. (Range: -100 to 500) Note: Valid only when text is justified.
minimumWordSpacingnumber r/wThe minimum word spacing, specified as a percentage of the font word space value. Note: Valid only when text is justified. (Range: 0 to 1000)
miterLimitnumber (range: 0 - 1000) r/wThe limit of the ratio of stroke width to miter length before a miter (pointed) join becomes a bevel (squared-off) join. (default: 4)
nestedGrepStylesNestedGrepStyles readonlyA collection of nested GREP styles.
nestedLineStylesNestedLineStyles readonlyA collection of nested line styles.
nestedStylesNestedStyles readonlyA collection of nested styles.
noBreakbool r/wIf true, keeps the text on the same line.
notesNotes readonlyA collection of notes.
numberingAlignmentListAlignment:
ListAlignment.LEFT_ALIGN
ListAlignment.CENTER_ALIGN
ListAlignment.RIGHT_ALIGN
r/wThe alignment of the number.
numberingApplyRestartPolicybool r/wIf true, apply the numbering restart policy.
numberingCharacterStyleCharacterStyle
String
r/wThe character style to be used for the number string. Can return: CharacterStyle or String.
numberingContinuebool r/wContinue the numbering at this level.
numberingExpressionstring r/wThe number string expression for numbering.
numberingFormatNumberingStyle
String
r/wNumbering format options. Can return: NumberingStyle enumerator or String.
numberingLevelnumber r/wThe level of the paragraph.
numberingRestartPoliciesNumberingRestartPolicy readonlyNumbering restart policies.
numberingStartAtnumber r/wDetermines starting number in a numbered list.
opentypeFeaturesArray of
Array of 2 Strings
Long Integers
r/wOpenType features. Can return: Array of Array of 2 Strings or Long Integers.
otfContextualAlternatebool r/wIf true, uses contextual alternate forms in OpenType fonts.
otfDiscretionaryLigaturebool r/wIf true, uses discretionary ligatures in OpenType fonts.
otfFigureStyleOTFFigureStyle:
OTFFigureStyle.TABULAR_LINING
OTFFigureStyle.PROPORTIONAL_OLDSTYLE
OTFFigureStyle.PROPORTIONAL_LINING
OTFFigureStyle.TABULAR_OLDSTYLE
OTFFigureStyle.DEFAULT_VALUE
r/wThe figure style in OpenType fonts.
otfFractionbool r/wIf true, uses fractions in OpenType fonts.
otfHistoricalbool r/wIf true, use historical forms in OpenType fonts.
otfJustificationAlternatebool r/wIf true, use alternate justification forms in OpenType fonts
otfLocalebool r/wIf true, uses localized forms in OpenType fonts.
otfMarkbool r/wIf true, uses mark positioning in OpenType fonts.
otfOrdinalbool r/wIf true, uses ordinals in OpenType fonts.
otfOverlapSwashbool r/wIf true, use overlapping swash forms in OpenType fonts
otfSlashedZerobool r/wIf true, use a slashed zeroes in OpenType fonts.
otfStretchedAlternatebool r/wIf true, use stretched alternate forms in OpenType fonts
otfStylisticAlternatebool r/wIf true, use stylistic alternate forms in OpenType fonts
otfStylisticSetsnumber r/wThe stylistic sets to use in OpenType fonts.
otfSwashbool r/wIf true, uses swash forms in OpenType fonts.
otfTitlingbool r/wIf true, uses titling forms in OpenType fonts.
ovalsOvals readonlyA collection of ellipses.
overflowsbool readonlyIf true, the story has overset text.
overprintFillbool r/wIf true, the fill color of the characters will overprint.
overprintStrokebool r/wIf true, the stroke of the characters will overprint.
pageItemsPageItems readonlyThe page items collection, which can be used to process all page items in a container (such as a document, page, or group), regardless of type.
paragraphDirectionParagraphDirectionOptions:
ParagraphDirectionOptions.LEFT_TO_RIGHT_DIRECTION
ParagraphDirectionOptions.RIGHT_TO_LEFT_DIRECTION
r/wParagraph direction.
paragraphJustificationParagraphJustificationOptions:
ParagraphJustificationOptions.DEFAULT_JUSTIFICATION
ParagraphJustificationOptions.ARABIC_JUSTIFICATION
ParagraphJustificationOptions.NASKH_JUSTIFICATION
r/wParagraph justification.
paragraphsParagraphs readonlyA collection of paragraphs.
parentDocument
XMLElement
readonlyThe parent of the Story (a XMLElement or Document).
pointSizeMeasurement Unit (Number or String) r/wThe text size.
polygonsPolygons readonlyA collection of polygons.
positionPosition:
Position.NORMAL
Position.SUPERSCRIPT
Position.SUBSCRIPT
Position.OT_SUPERSCRIPT
Position.OT_SUBSCRIPT
Position.OT_NUMERATOR
Position.OT_DENOMINATOR
r/wThe text position relative to the baseline.
positionalFormPositionalForms:
PositionalForms.NONE
PositionalForms.CALCULATE
PositionalForms.INITIAL
PositionalForms.MEDIAL
PositionalForms.FINAL
PositionalForms.ISOLATED
r/wThe OpenType positional form.
propertiesObject r/wA property that allows setting of several properties at the same time.
rectanglesRectangles readonlyA collection of rectangles.
rightIndentMeasurement Unit (Number or String) r/wThe width of the right indent.
ruleAbovebool r/wIf true, places a rule above the paragraph.
ruleAboveColorString
Swatch
r/wThe swatch (color, gradient, tint, or mixed ink) applied to the paragraph rule above. Can return: Swatch or String.
ruleAboveGapColorString
Swatch
r/wThe swatch (color, gradient, tint, or mixed ink) applied to the stroke gap of the paragraph rule above. Note: Valid only when the paragraph rule above type is not solid. Can return: Swatch or String.
ruleAboveGapOverprintbool r/wIf true, the stroke gap of the paragraph rule above will overprint. Note: Valid only the rule above type is not solid.
ruleAboveGapTintnumber r/wThe tint (as a percentage) of the stroke gap color of the paragraph rule. (Range: 0 to 100) Note: Valid only when the rule above type is not solid.
ruleAboveLeftIndentMeasurement Unit (Number or String) r/wThe distance to indent the left edge of the paragraph rule above (based on either the text width or the column width of the first line in the paragraph.
ruleAboveLineWeightMeasurement Unit (Number or String) r/wThe line weight of the rule above.
ruleAboveOffsetMeasurement Unit (Number or String) r/wThe amount to offset the paragraph rule above from the baseline of the first line the paragraph.
ruleAboveOverprintbool r/wIf true, the paragraph rule above will overprint.
ruleAboveRightIndentMeasurement Unit (Number or String) r/wThe distance to indent the right edge of the paragraph rule above (based on either the text width or the column width of the first line in the paragraph.
ruleAboveTintnumber r/wThe tint (as a percentage) of the paragraph rule above. (Range: 0 to 100)
ruleAboveTypeString
StrokeStyle
r/wThe stroke type of the rule above the paragraph. Can return: StrokeStyle or String.
ruleAboveWidthRuleWidth:
RuleWidth.TEXT_WIDTH
RuleWidth.COLUMN_WIDTH
r/wThe basis (text width or column width) used to calculate the width of the paragraph rule above.
ruleBelowbool r/wIf true, applies a paragraph rule below.
ruleBelowColorString
Swatch
r/wThe swatch (color, gradient, tint, or mixed ink) applied to the paragraph rule below. Can return: Swatch or String.
ruleBelowGapColorString
Swatch
r/wThe swatch (color, gradient, tint, or mixed ink) applied to the stroke gap of the paragraph rule below. Note: Valid only when the paragraph rule below type is not solid. Can return: Swatch or String.
ruleBelowGapOverprintbool r/wIf true, the gap color of the rule below will overprint.
ruleBelowGapTintnumber r/wThe tint (as a percentage) of the stroke gap color of the paragraph rule below. (Range: 0 to 100) Note: Valid only when the paragraph rule below type is not solid.
ruleBelowLeftIndentMeasurement Unit (Number or String) r/wThe distance to indent the left edge of the paragraph rule below (based on either the text width or the column width of the last line in the paragraph.
ruleBelowLineWeightMeasurement Unit (Number or String) r/wThe line weight of the rule below.
ruleBelowOffsetMeasurement Unit (Number or String) r/wThe amount to offset the the paragraph rule below from the baseline of the last line of the paragraph.
ruleBelowOverprintbool r/wIf true, the rule below will overprint.
ruleBelowRightIndentMeasurement Unit (Number or String) r/wThe distance to indent the right edge of the paragraph rule below (based on either the text width or the column width of the last line in the paragraph.
ruleBelowTintnumber r/wThe tint (as a percentage) of the paragraph rule below. (Range: 0 to 100)
ruleBelowTypeString
StrokeStyle
r/wThe stroke type of the rule below the paragraph. Can return: StrokeStyle or String.
ruleBelowWidthRuleWidth:
RuleWidth.TEXT_WIDTH
RuleWidth.COLUMN_WIDTH
r/wThe basis (text width or column width) used to calculate the width of the paragraph rule below.
singleWordJustificationSingleWordJustification:
SingleWordJustification.LEFT_ALIGN
SingleWordJustification.CENTER_ALIGN
SingleWordJustification.RIGHT_ALIGN
SingleWordJustification.FULLY_JUSTIFIED
r/wThe alignment to use for lines that contain a single word.
skewnumber r/wThe skew angle of the text. (Range: -85 to 85)
spaceAfterMeasurement Unit (Number or String) r/wThe height of the paragraph space below.
spaceBeforeMeasurement Unit (Number or String) r/wThe height of the paragraph space above.
startParagraphStartParagraph:
StartParagraph.ANYWHERE
StartParagraph.NEXT_COLUMN
StartParagraph.NEXT_FRAME
StartParagraph.NEXT_PAGE
StartParagraph.NEXT_ODD_PAGE
StartParagraph.NEXT_EVEN_PAGE
r/wThe location at which to start the paragraph.
storyPreferencesStoryPreference readonlyStory preference settings.
storyTitlestring r/wTitle for this InCopy story.
storyTypeStoryTypes:
StoryTypes.REGULAR_STORY
StoryTypes.TOC_STORY
StoryTypes.INDEXING_STORY
readonlyThe type of story.
strikeThroughColorString
Swatch
r/wThe swatch (color, gradient, tint, or mixed ink) applied to the strikethrough stroke. Can return: Swatch or String.
strikeThroughGapColorString
Swatch
r/wThe swatch (color, gradient, tint, or mixed ink) applied to the gap of the strikethrough stroke. Can return: Swatch or String.
strikeThroughGapOverprintbool r/wIf true, the gap color of the strikethrough stroke will overprint. Note: Valid when strike through type is not solid.
strikeThroughGapTintnumber r/wThe tint (as a percentage) of the strikethrough stroke gap color. (Range: 0 to 100) Note: Valid when strike through type is not solid.
strikeThroughOffsetMeasurement Unit (Number or String) r/wThe amount by which to offset the strikethrough stroke from the text baseline.
strikeThroughOverprintbool r/wIf true, the strikethrough stroke will overprint.
strikeThroughTintnumber r/wThe tint (as a percentage) of the strikethrough stroke. (Range: 0 to 100)
strikeThroughTypeString
StrokeStyle
r/wThe stroke type of the strikethrough stroke. Can return: StrokeStyle or String.
strikeThroughWeightMeasurement Unit (Number or String) r/wThe stroke weight of the strikethrough stroke.
strikeThrubool r/wIf true, draws a strikethrough line through the text.
strokeAlignmentTextStrokeAlign:
TextStrokeAlign.CENTER_ALIGNMENT
TextStrokeAlign.OUTSIDE_ALIGNMENT
r/wThe stroke alignment applied to the text.
strokeColorString
Swatch
r/wThe swatch (color, gradient, tint, or mixed ink) applied to the stroke of the text. Can also accept: String.
strokeTintnumber r/wThe tint (as a percentage) of the stroke color of the text. (To specify a tint percentage, use a number in the range of 0 to 100; to use the inherited or overridden value, use -1.)
strokeWeightMeasurement Unit (Number or String) r/wThe stroke weight applied to the characters of the text.
styleOverriddenbool readonlyIf true, the applied style has been overridden with additional attributes.
tabListArray of
Arrays of Property Name/Value Pairs
r/wA list of the tab stops in the paragraph. Can return: Array of Arrays of Property Name/Value Pairs.
tabStopsTabStops readonlyA collection of tab stops.
tablesTables readonlyA collection of tables.
textColumnsTextColumns readonlyA collection of text columns.
textContainersArray of
TextFrames
TextPaths
readonlyArray of text frames or text paths. Can return: Array of TextFrames or TextPaths.
textFramesTextFrames readonlyA collection of text frames.
textStyleRangesTextStyleRanges readonlyA collection of text style ranges.
textVariableInstancesTextVariableInstances readonlyA collection of text variable instances.
textsTexts readonlyA collection of text objects.
trackChangesbool r/wIf true, track changes is turned on.
trackingnumber r/wThe amount by which to loosen or tighten a block of text, specified in thousands of an em.
underlinebool r/wIf true, underlines the text.
underlineColorString
Swatch
r/wThe swatch (color, gradient, tint, or mixed ink) applied to the underline stroke. . Can return: Swatch or String.
underlineGapColorString
Swatch
r/wThe swatch (color, gradient, tint, or mixed ink) applied to the gap of the underline stroke. Note: Valid when underline type is not solid. Can return: Swatch or String.
underlineGapOverprintbool r/wIf true, the gap color of the underline stroke will overprint.
underlineGapTintnumber r/wThe tint (as a percentage) of the gap color of the underline stroke. (Range: 0 to 100) Note: Valid when underline type is not solid.
underlineOffsetMeasurement Unit (Number or String) r/wThe amount by which to offset the underline from the text baseline.
underlineOverprintbool r/wIf true, the underline stroke color will overprint.
underlineTintnumber r/wThe underline stroke tint (as a percentage). (Range: 0 to 100)
underlineTypeString
StrokeStyle
r/wThe stroke type of the underline stroke. Can return: StrokeStyle or String.
underlineWeightMeasurement Unit (Number or String) r/wThe stroke weight of the underline stroke.
verticalScalenumber r/wThe vertical scaling applied to the text as a percentage of its current size. (Range: 1 to 1000)
wordsWords readonlyA collection of words.
xOffsetDiacriticnumber r/wThe x (horizontal) offset for diacritic adjustment.
yOffsetDiacriticnumber r/wThe y (vertical) offset for diacritic adjustment.

Methods

Instances

void autoTag ()
Tag the object or the parent story using default tags defined in XML preference.

Array of Text changeGlyph ([reverseOrder: bool])
Finds glyphs that match the find what value and replaces the glyphs with the change to value.

ParameterTypeDescription
reverseOrderboolIf true, returns the results in reverse order. (Optional)

Array of Text changeGrep ([reverseOrder: bool])
Finds text that matches the find what value and replaces the text with the change to value.

ParameterTypeDescription
reverseOrderboolIf true, returns the results in reverse order. (Optional)

Array of Text changeText ([reverseOrder: bool])
Finds text that matches the find what value and replaces the text with the change to value.

ParameterTypeDescription
reverseOrderboolIf true, returns the results in reverse order. (Optional)

void changecase (using: ChangecaseMode)
Sets the case of the text.

ParameterTypeDescription
usingChangecaseMode:
ChangecaseMode.UPPERCASE
ChangecaseMode.LOWERCASE
ChangecaseMode.TITLECASE
ChangecaseMode.SENTENCECASE
The text case option.

bool checkIn ([versionComments: string][, forceSave: bool=false])
Checks in the story or stories.

ParameterTypeDescription
versionCommentsstringThe comment for this version. (Optional)
forceSaveboolIf true, forcibly saves a version. (Optional) (default: false)

bool checkOut ()
Checks out the story.

void clearOverrides ([overridesToClear: OverrideType=OverrideType.ALL])
Clears the specified types of override.

ParameterTypeDescription
overridesToClearOverrideType:
OverrideType.ALL
OverrideType.CHARACTER_ONLY
OverrideType.PARAGRAPH_ONLY
The types of override to clear. (Optional) (default: OverrideType.ALL)

void convertBulletsAndNumberingToText ()
Convert bullets and numbering to text.

Array of PageItem createOutlines ([deleteOriginal: bool=true])
Converts text to outlines. Each line of text becomes a polygon object. When the converted text is a single letter that has no internal spaces or detached parts, the polygon contains only a single path. Note: To determine whether a font allows the creation of outlines, see allow outlines.

ParameterTypeDescription
deleteOriginalboolIf true, deletes the original text. If false, creates the outlines as separate object(s) on top of the text. (Optional) (default: true)

Text duplicate (to: LocationOptions[, reference: any])
Duplicates the text in the specified location.

ParameterTypeDescription
toLocationOptions:
LocationOptions.BEFORE
LocationOptions.AFTER
LocationOptions.AT_END
LocationOptions.AT_BEGINNING
LocationOptions.UNKNOWN
The location relative to the reference object or within the containing object.
referenceCell
Column
PageItem
Row
Story
Table
Text
The reference object. Note: Required when the to parameter specifies before or after. Can accept: Text, Story, Cell, Row, Column, Table or PageItem. (Optional)

void exportFile (format: any, to: File[, showingOptions: bool=false][, using: PDFExportPreset][, versionComments: string][, forceSave: bool=false])
Exports the object(s) to a file.

ParameterTypeDescription
formatExportFormat
String
The export format, specified as an enumeration value or as an extension that appears in the Save as type or Format menu in the Export dialog. Can accept: ExportFormat enumerator or String.
toFileThe path to the export file.
showingOptionsboolIf true, displays the export options dialog. (Optional) (default: false)
usingPDFExportPresetThe export style. (Optional)
versionCommentsstringThe comment for this version. (Optional)
forceSaveboolIf true, forcibly saves a version. (Optional) (default: false)

string extractLabel (key: string)
Gets the label value associated with the specified key.

ParameterTypeDescription
keystringThe key.

Array of Text findGlyph ([reverseOrder: bool])
Finds glyphs that match the find what value.

ParameterTypeDescription
reverseOrderboolIf true, returns the results in reverse order. (Optional)

Array of Text findGrep ([reverseOrder: bool])
Finds text that matches the find what value.

ParameterTypeDescription
reverseOrderboolIf true, returns the results in reverse order. (Optional)

Array of Text findText ([reverseOrder: bool])
Finds text that matches the find what value.

ParameterTypeDescription
reverseOrderboolIf true, returns the results in reverse order. (Optional)

Array of Story getElements ()
Resolves the object specifier, creating an array of object references.

void insertLabel (key: string, value: string)
Sets the label to the value associated with the specified key.

ParameterTypeDescription
keystringThe key.
valuestringThe value.

void markup (using: XMLElement)
Associates the page item with the specified XML element while preserving existing content.

ParameterTypeDescription
usingXMLElementThe XML element.

Text move (to: LocationOptions[, reference: any])
Moves the text to the specified location.

ParameterTypeDescription
toLocationOptions:
LocationOptions.BEFORE
LocationOptions.AFTER
LocationOptions.AT_END
LocationOptions.AT_BEGINNING
LocationOptions.UNKNOWN
The location relative to the reference object or within the containing object.
referenceCell
Column
PageItem
Row
Story
Table
Text
The reference object. Note: Required when the to parameter specifies before or after. Can accept: Text, Story, Cell, Row, Column, Table or PageItem. (Optional)

void placeXML (using: XMLElement)
Places XML content into the specified object. Note: Replaces any existing content.

ParameterTypeDescription
usingXMLElementThe XML element whose content you want to place.

void recompose ()
Recomposes the text in the Story.

void remove ()
Deletes the Story.

bool revert ()
Reverts the document to its state at the last save operation.

StoryWindow storyEdit ()
Opens the story in a story editor window.

string toSource ()
Generates a string which, if executed, will return the Story.

string toSpecifier ()
Retrieves the object specifier.

Element of

AssignedStory.storyReference

Change.parent

Character.parentStory

DataMergeTextPlaceholder.parentStory

InsertionPoint.parentStory

Line.parentStory

Link.parent

NestedGrepStyle.parent

NestedLineStyle.parent

NestedStyle.parent

Paragraph.parentStory

StoryPreference.parent

TabStop.parent

Text.parentStory

TextColumn.parentStory

TextFrame.parentStory

TextPath.parentStory

TextStyleRange.parentStory

Word.parentStory

XMLElement.parentStory

XMLElement.xmlContent

Used in:

Text Character.duplicate (to: LocationOptions[, reference: any])

Text Character.move (to: LocationOptions[, reference: any])

DataMergeTextPlaceholder DataMergeTextPlaceholders.add (parentStory: Story, storyOffset: any, field: DataMergeField[, withProperties: Object])

Text InsertionPoint.duplicate (to: LocationOptions[, reference: any])

Text InsertionPoint.move (to: LocationOptions[, reference: any])

Text Line.duplicate (to: LocationOptions[, reference: any])

Text Line.move (to: LocationOptions[, reference: any])

Note Note.move (to: LocationOptions[, reference: any])

Text Paragraph.duplicate (to: LocationOptions[, reference: any])

Text Paragraph.move (to: LocationOptions[, reference: any])

array of Story Stories.itemByRange (from: any, to: any)

Story Stories.nextItem (obj: Story)

Story Stories.previousItem (obj: Story)

Text Story.duplicate (to: LocationOptions[, reference: any])

Text Story.move (to: LocationOptions[, reference: any])

Table Tables.add ([to: LocationOptions=LocationOptions.UNKNOWN][, reference: any][, withProperties: Object])

Text Text.duplicate (to: LocationOptions[, reference: any])

Text Text.move (to: LocationOptions[, reference: any])

Text TextColumn.duplicate (to: LocationOptions[, reference: any])

Text TextColumn.move (to: LocationOptions[, reference: any])

Text TextStyleRange.duplicate (to: LocationOptions[, reference: any])

Text TextStyleRange.move (to: LocationOptions[, reference: any])

TextVariableInstance TextVariableInstances.add ([to: LocationOptions=LocationOptions.UNKNOWN][, reference: any][, withProperties: Object])

Text Word.duplicate (to: LocationOptions[, reference: any])

Text Word.move (to: LocationOptions[, reference: any])

void XMLElement.markup (using: any)

void XMLElement.placeXML (using: any)

XMLElement XMLElements.add (markupTag: any[, xmlContent: any][, withProperties: Object])

Text XmlStory.duplicate (to: LocationOptions[, reference: any])

Return

Array of Story Document.createTOC (using: TOCStyle[, replacing: bool=false][, fromBook: Book][, placePoint: Array of Measurement Unit (Number or String)][, includeOverset: bool=false][, destinationLayer: Layer])

Array of Story Index.generate ([on: any][, placePoint: Array of Measurement Unit (Number or String)][, destinationLayer: Layer][, autoflowing: bool=false][, includeOverset: bool=false])

Story Stories.[] (index: number)

Story Stories.anyItem ()

Array of Story Stories.everyItem ()

Story Stories.firstItem ()

Story Stories.item (index: any)

Story Stories.itemByID (id: number)

Story Stories.itemByName (name: string)

Array of Story Stories.itemByRange (from: any, to: any)

Story Stories.lastItem ()

Story Stories.middleItem ()

Story Stories.nextItem (obj: Story)

Story Stories.previousItem (obj: Story)

Array of Story Story.getElements ()

Jongware, 20-Jun-2010 v3.0.3dContents :: Index