Adobe InCopy CS5.5 (7.5) Object Model JS: ParagraphStyle

InCopy CS5.5

Class

ParagraphStyle

 A paragraph style.

QuickLinks

addEventListener, convertBulletsAndNumberingToText, duplicate, extractLabel, getElements, insertLabel, move, remove, removeEventListener, toSource, toSpecifier

Hierarchy

Application | Document | ParagraphStyleGroup
ParagraphStyle
Bullet | Event | EventListener | MutationEvent | NestedGrepStyle | NestedLineStyle | NestedStyle | NumberingRestartPolicy | Preference | StyleExportTagMap | TabStop

Properties

PropertyTypeAccessDescription
alignToBaselinebool r/wIf true, aligns the baseline of the text to the baseline grid.
allowArbitraryHyphenationbool r/wIf true, words unassociated with a hyphenation dictionary can break to the next line on any character.
appliedFontFontString r/wThe font applied to the ParagraphStyle, 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.
appliedNumberingListNumberingList
String
r/wThe list to be part of. Can return: NumberingList or String.
autoLeadingnumber r/wThe percent of the type size to use for auto leading. (Range: 0 to 500).
autoTcynumber r/wThe number of half-width characters at or below which the characters automatically run horizontally in vertical text.
autoTcyIncludeRomanbool r/wIf true, auto tcy includes Roman characters.
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.
basedOnParagraphStyle
String
r/wThe style that this style is based on. Can return: ParagraphStyle or String.
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.
bunriKinshibool r/wIf true, adds the double period (..), ellipse (...), and double hyphen (--) to the selected kinsoku set. Note: Valid only when a kinsoku set is in effect.
capitalizationCapitalization:
Capitalization.NORMAL
Capitalization.SMALL_CAPS
Capitalization.ALL_CAPS
Capitalization.CAP_TO_SMALL_CAP
r/wThe capitalization scheme.
characterAlignmentCharacterAlignment:
CharacterAlignment.ALIGN_BASELINE
CharacterAlignment.ALIGN_EM_TOP
CharacterAlignment.ALIGN_EM_CENTER
CharacterAlignment.ALIGN_EM_BOTTOM
CharacterAlignment.ALIGN_ICF_TOP
CharacterAlignment.ALIGN_ICF_BOTTOM
r/wThe alignment of small characters to the largest character in the line.
characterDirectionCharacterDirectionOptions:
CharacterDirectionOptions.DEFAULT_DIRECTION
CharacterDirectionOptions.LEFT_TO_RIGHT_DIRECTION
CharacterDirectionOptions.RIGHT_TO_LEFT_DIRECTION
r/wThe direction of the character.
characterRotationnumber r/wThe rotation angle (in degrees) of individual characters. Note: The rotation is counterclockwise.
cjkGridTrackingbool r/wIf true, uses grid tracking to track non-Roman characters in CJK grids.
composerstring r/wThe text composer to use to compose the text.
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.
eventListenersEventListeners EventListener readonlyA collection of event listeners.
eventsEvents Event readonlyA collection of events.
fillColorString
Swatch
r/wThe swatch (color, gradient, tint, or mixed ink) applied to the fill of the ParagraphStyle. . Can also accept: String.
fillTintnumber r/wThe tint (as a percentage) of the fill color of the ParagraphStyle. (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.
glyphFormAlternateGlyphForms:
AlternateGlyphForms.NONE
AlternateGlyphForms.TRADITIONAL_FORM
AlternateGlyphForms.EXPERT_FORM
AlternateGlyphForms.JIS78_FORM
AlternateGlyphForms.JIS83_FORM
AlternateGlyphForms.MONOSPACED_HALF_WIDTH_FORM
AlternateGlyphForms.THIRD_WIDTH_FORM
AlternateGlyphForms.QUARTER_WIDTH_FORM
AlternateGlyphForms.NLC_FORM
AlternateGlyphForms.PROPORTIONAL_WIDTH_FORM
AlternateGlyphForms.FULL_WIDTH_FORM
AlternateGlyphForms.JIS04_FORM
AlternateGlyphForms.JIS90_FORM
r/wThe glyph variant to substitute for standard glyphs.
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.
gradientFillStart Array 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.
gradientStrokeStart Array 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].
gridAlignFirstLineOnlybool r/wIf true, aligns only the first line to the frame grid or baseline grid. If false, aligns all lines to the grid.
gridAlignmentGridAlignment:
GridAlignment.NONE
GridAlignment.ALIGN_BASELINE
GridAlignment.ALIGN_EM_TOP
GridAlignment.ALIGN_EM_CENTER
GridAlignment.ALIGN_EM_BOTTOM
GridAlignment.ALIGN_ICF_TOP
GridAlignment.ALIGN_ICF_BOTTOM
r/wThe alignment to the frame grid or baseline grid.
gridGyoudorinumber r/wThe manual gyoudori setting.
horizontalScalenumber r/wThe horizontal scaling applied to the ParagraphStyle.
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 ParagraphStyle.
ignoreEdgeAlignmentbool r/wIf true, ignores optical edge alignment for the paragraph.
importedbool readonlyIf true, the style was imported from another document.
indexnumber readonlyThe index of the ParagraphStyle within its containing object.
isValidbool readonlyReturns true if the object specifier resolves to valid objects.
jidorinumber r/wThe number of grid squares in which to arrange the text.
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.
keepWithPreviousbool r/wIf the first line in the paragraph should be kept with the last line of previous paragraph.
kentenAlignmentKentenAlignment:
KentenAlignment.ALIGN_KENTEN_LEFT
KentenAlignment.ALIGN_KENTEN_CENTER
r/wThe alignment of kenten characters relative to the parent characters.
kentenCharacterSetKentenCharacterSet:
KentenCharacterSet.CHARACTER_INPUT
KentenCharacterSet.SHIFT_JIS
KentenCharacterSet.JIS
KentenCharacterSet.KUTEN
KentenCharacterSet.UNICODE
r/wThe character set used for the custom kenten character. Note: Valid only when kenten kind is custom.
kentenCustomCharacterstring r/wThe character used for kenten. Note: Valid only when kenten kind is custom.
kentenFillColorString
Swatch
r/wThe swatch (color, gradient, tint, or mixed ink) applied to the fill of kenten characters. Can return: Swatch or String.
kentenFontFont
String
r/wThe font to use for kenten characters. Can return: Font or String.
kentenFontSizenumber r/wThe size (in points) of kenten characters.
kentenFontStyleNothingEnum
String
r/wThe font style of kenten characters. Can return: String or NothingEnum enumerator.
kentenKindKentenCharacter:
KentenCharacter.NONE
KentenCharacter.KENTEN_SESAME_DOT
KentenCharacter.KENTEN_WHITE_SESAME_DOT
KentenCharacter.KENTEN_BLACK_CIRCLE
KentenCharacter.KENTEN_WHITE_CIRCLE
KentenCharacter.KENTEN_BLACK_TRIANGLE
KentenCharacter.KENTEN_WHITE_TRIANGLE
KentenCharacter.KENTEN_BULLSEYE
KentenCharacter.KENTEN_FISHEYE
KentenCharacter.KENTEN_SMALL_BLACK_CIRCLE
KentenCharacter.KENTEN_SMALL_WHITE_CIRCLE
KentenCharacter.CUSTOM
r/wThe style of kenten characters.
kentenOverprintFillAdornmentOverprint:
AdornmentOverprint.AUTO
AdornmentOverprint.OVERPRINT_ON
AdornmentOverprint.OVERPRINT_OFF
r/wThe method of overprinting the kenten fill.
kentenOverprintStrokeAdornmentOverprint:
AdornmentOverprint.AUTO
AdornmentOverprint.OVERPRINT_ON
AdornmentOverprint.OVERPRINT_OFF
r/wThe method of overprinting the kenten stroke.
kentenPlacementnumber r/wThe distance between kenten characters and their parent characters.
kentenPositionRubyKentenPosition:
RubyKentenPosition.ABOVE_RIGHT
RubyKentenPosition.BELOW_LEFT
r/wThe kenten position relative to the parent character.
kentenStrokeColorString
Swatch
r/wThe swatch (color, gradient, tint, or mixed ink) applied to the stroke of kenten characters. Can return: Swatch or String.
kentenStrokeTintnumber r/wThe stroke tint (as a percentage) of kenten characters. (Range: 0 to 100)
kentenTintnumber r/wThe fill tint (as a percentage) of kenten characters. (Range: 0 to 100)
kentenWeightnumber r/wThe stroke weight (in points) of kenten characters.
kentenXScalenumber r/wThe horizontal size of kenten characters as a percent of the original size.
kentenYScalenumber r/wThe vertical size of kenten charachers as a percent of the original size.
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.
kinsokuHangTypeKinsokuHangTypes:
KinsokuHangTypes.NONE
KinsokuHangTypes.KINSOKU_HANG_REGULAR
KinsokuHangTypes.KINSOKU_HANG_FORCE
r/wThe type of hanging punctuation to allow. Note: Valid only when a kinsoku set is in effect.
kinsokuSetKinsokuSet
KinsokuTable
String
r/wThe kinsoku set that determines legitimate line breaks. Can return: KinsokuTable, KinsokuSet enumerator or String.
kinsokuTypeKinsokuType:
KinsokuType.KINSOKU_PUSH_IN_FIRST
KinsokuType.KINSOKU_PUSH_OUT_FIRST
KinsokuType.KINSOKU_PUSH_OUT_ONLY
KinsokuType.KINSOKU_PRIORITIZE_ADJUSTMENT_AMOUNT
r/wThe type of kinsoku processing for preventing kinsoku characters from beginning or ending a line. Note: Valid only when a kinsoku set is defined.
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.
leadingAkinumber r/wThe amount of space before each character.
leadingModelLeadingModel:
LeadingModel.LEADING_MODEL_ROMAN
LeadingModel.LEADING_MODEL_AKI_BELOW
LeadingModel.LEADING_MODEL_AKI_ABOVE
LeadingModel.LEADING_MODEL_CENTER
LeadingModel.LEADING_MODEL_CENTER_DOWN
r/wThe point from which leading is measured from line to line.
leftIndentMeasurement Unit (Number or String) r/wThe width of the left indent.
ligaturesbool r/wIf true, replaces specific character combinations (e.g., fl, fi) with ligature characters.
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)
mojikumiMojikumiTable
MojikumiTableDefaults
String
r/wThe mojikumi table. For information, see mojikumi table defaults. Can return: MojikumiTable, String or MojikumiTableDefaults enumerator.
namestring r/wThe name of the ParagraphStyle.
nestedGrepStylesNestedGrepStyles NestedGrepStyle readonlyA collection of nested GREP styles.
nestedLineStylesNestedLineStyles NestedLineStyle readonlyA collection of nested line styles.
nestedStylesNestedStyles NestedStyle readonlyA collection of nested styles.
nextStyleParagraphStyle r/wThe style to apply to new paragraphs that follow paragraphs tagged with this style.
noBreakbool r/wIf true, keeps the text on the same line.
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.
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.
otfHVKanabool r/wIf true, switches hiragana fonts, which have different glyphs for horizontal and vertical.
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
otfProportionalMetricsbool r/wIf true, kerns according to proportional CJK metrics in OpenType fonts.
otfRomanItalicsbool r/wIf true, applies italics to half-width alphanumerics.
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.
overprintFillbool r/wIf true, the fill color of the characters will overprint.
overprintStrokebool r/wIf true, the stroke of the characters will overprint.
paragraphDirectionParagraphDirectionOptions:
ParagraphDirectionOptions.LEFT_TO_RIGHT_DIRECTION
ParagraphDirectionOptions.RIGHT_TO_LEFT_DIRECTION
r/wParagraph direction.
paragraphGyoudoribool r/wIf true, the gyoudori mode applies to the entire paragraph. If false, the gyoudori mode applies to each line in the paragraph.
paragraphJustificationParagraphJustificationOptions:
ParagraphJustificationOptions.DEFAULT_JUSTIFICATION
ParagraphJustificationOptions.ARABIC_JUSTIFICATION
ParagraphJustificationOptions.NASKH_JUSTIFICATION
r/wParagraph justification.
parentApplication
Document
ParagraphStyleGroup
readonlyThe parent of the ParagraphStyle (a Document, Application or ParagraphStyleGroup).
pointSizeMeasurement Unit (Number or String) r/wThe text size.
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.
preferencesPreferences Preference readonlyA collection of preferences objects.
previewColor3 Reals (0 - 255)
NothingEnum
UIColors
r/wThe color to use for preview, specified either as an array of three doubles, each in the range 0 to 255 and representing R, G, and B values, or as a UI color. Can return: Array of 3 Reals (0 - 255) or UIColors enumerator or NothingEnum enumerator.
propertiesObject r/wA property that allows setting of several properties at the same time.
rensuujibool r/wIf true, disallows line breaks in numbers. If false, lines can break between digits in multi-digit numbers.
rightIndentMeasurement Unit (Number or String) r/wThe width of the right indent.
rotateSingleByteCharactersbool r/wIf true, rotates Roman characters in vertical text.
rubyAlignmentRubyAlignments:
RubyAlignments.RUBY_LEFT
RubyAlignments.RUBY_CENTER
RubyAlignments.RUBY_RIGHT
RubyAlignments.RUBY_FULL_JUSTIFY
RubyAlignments.RUBY_JIS
RubyAlignments.RUBY_EQUAL_AKI
RubyAlignments.RUBY_1_AKI
r/wThe ruby alignment.
rubyAutoAlignbool r/wIf true, auto aligns ruby.
rubyAutoScalingbool r/wIf true, automatically scales ruby to the specified percent of parent text size. For information on specifying a percent, see ruby parent scaling percent.
rubyAutoTcyAutoScalebool r/wIf true, automatically scales glyphs in auto tcy (tate-chuu-yoko) in ruby to fit one em.
rubyAutoTcyDigitsnumber r/wThe number of digits included in auto tcy (tate-chuu-yoko) in ruby.
rubyAutoTcyIncludeRomanbool r/wIf true, includes Roman characters in auto tcy (tate-chuu-yoko) in ruby.
rubyFillString
Swatch
r/wThe swatch (color, gradient, tint, or mixed ink) applied to the fill of ruby characters. Can return: Swatch or String.
rubyFontFont
String
r/wThe font applied to ruby characters. Can return: Font or String.
rubyFontSizenumber r/wThe size (in points) of ruby characters.
rubyFontStyleNothingEnum
String
r/wThe font style of ruby characters. Can return: String or NothingEnum enumerator.
rubyOpenTypeProbool r/wIf true, uses OpenType Pro fonts for ruby.
rubyOverhangbool r/wIf true, constrains ruby overhang to the specified amount. For information on specifying an amount, see ruby parent overhang amount.
rubyOverprintFillAdornmentOverprint:
AdornmentOverprint.AUTO
AdornmentOverprint.OVERPRINT_ON
AdornmentOverprint.OVERPRINT_OFF
r/wThe method of overprinting the ruby fill.
rubyOverprintStrokeAdornmentOverprint:
AdornmentOverprint.AUTO
AdornmentOverprint.OVERPRINT_ON
AdornmentOverprint.OVERPRINT_OFF
r/wThe method of overprinting the ruby stroke.
rubyParentOverhangAmountRubyOverhang:
RubyOverhang.NONE
RubyOverhang.RUBY_OVERHANG_ONE_RUBY
RubyOverhang.RUBY_OVERHANG_HALF_RUBY
RubyOverhang.RUBY_OVERHANG_ONE_CHAR
RubyOverhang.RUBY_OVERHANG_HALF_CHAR
RubyOverhang.RUBY_OVERHANG_NO_LIMIT
r/wThe amount by which ruby characters can overhang the parent text.
rubyParentScalingPercentnumber r/wThe amount (as a percentage) to scale the parent text size to determine the ruby text size.
rubyParentSpacingRubyParentSpacing:
RubyParentSpacing.RUBY_PARENT_NO_ADJUSTMENT
RubyParentSpacing.RUBY_PARENT_BOTH_SIDES
RubyParentSpacing.RUBY_PARENT_121_AKI
RubyParentSpacing.RUBY_PARENT_EQUAL_AKI
RubyParentSpacing.RUBY_PARENT_FULL_JUSTIFY
r/wThe ruby spacing relative to the parent text.
rubyPositionRubyKentenPosition:
RubyKentenPosition.ABOVE_RIGHT
RubyKentenPosition.BELOW_LEFT
r/wThe position of ruby characters relative to the parent text.
rubyStrokeString
Swatch
r/wThe swatch (color, gradient, tint, or mixed ink) applied to the stroke of ruby characters. Can return: Swatch or String.
rubyStrokeTintnumber r/wThe stroke tint (as a percentage) of ruby characters.
rubyTintnumber r/wThe tint (as a percentage) of the ruby fill color. (Range: 0 to 100)
rubyTypeRubyTypes:
RubyTypes.GROUP_RUBY
RubyTypes.PER_CHARACTER_RUBY
r/wThe ruby type.
rubyWeightnumber r/wThe stroke weight (in points) of ruby characters.
rubyXOffsetnumber r/wThe amount of horizontal space between ruby and parent characters.
rubyXScalenumber r/wThe horizontal size of ruby characters, specified as a percent of the original size.
rubyYOffsetnumber r/wThe amount of vertical space between ruby and parent characters.
rubyYScalenumber r/wThe vertical size of ruby characters, specified as a percent of the original size.
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.
scaleAffectsLineHeightbool r/wIf true, the line changes size when characters are scaled.
shataiAdjustRotationbool r/wIf true, applies shatai rotation.
shataiAdjustTsumebool r/wIf true, adjusts shatai tsume.
shataiDegreeAnglenumber r/wThe shatai lens angle (in degrees).
shataiMagnificationnumber r/wThe amount (as a percentage) of shatai obliquing to apply.
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 ParagraphStyle.
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.
spanColumnMinSpaceAfterMeasurement Unit (Number or String) r/wThe minimum space after a span or a split column
spanColumnMinSpaceBeforeMeasurement Unit (Number or String) r/wThe minimum space before a span or a split column
spanColumnTypeSpanColumnTypeOptions:
SpanColumnTypeOptions.SINGLE_COLUMN
SpanColumnTypeOptions.SPAN_COLUMNS
SpanColumnTypeOptions.SPLIT_COLUMNS
r/wWhether a paragraph should be a single column, span columns or split columns
spanSplitColumnCountShort Integer (1 - 40)
SpanColumnCountOptions
r/wThe number of columns a paragraph spans or the number of split columns. Can return: Short Integer (1 - 40) or SpanColumnCountOptions enumerator.
splitColumnInsideGutterMeasurement Unit (Number or String) r/wThe inside gutter if the paragraph splits columns
splitColumnOutsideGutterMeasurement Unit (Number or String) r/wThe outside gutter if the paragraph splits columns
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.
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 ParagraphStyle. Can also accept: String.
strokeTintnumber r/wThe tint (as a percentage) of the stroke color of the ParagraphStyle. (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.
styleExportTagMapsStyleExportTagMaps StyleExportTagMap readonlyA collection of style export tag maps.
tabList Array 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 TabStop readonlyA collection of tab stops.
tatechuyokobool r/wIf true, makes the character horizontal in vertical text.
tatechuyokoXOffsetnumber r/wThe horizontal offset for horizontal characters in vertical text.
tatechuyokoYOffsetnumber r/wThe vertical offset for horizontal characters in vertical text.
trackingnumber r/wThe amount by which to loosen or tighten a block of text, specified in thousands of an em.
trailingAkinumber r/wThe amount of space after each character.
treatIdeographicSpaceAsSpacebool r/wIf true, ideographic spaces will not wrap to the next line like text characters.
tsumenumber r/wThe amount of horizontal character compression.
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 ParagraphStyle.
warichubool r/wIf true, turns on warichu.
warichuAlignmentWarichuAlignment:
WarichuAlignment.AUTO
WarichuAlignment.LEFT_ALIGN
WarichuAlignment.CENTER_ALIGN
WarichuAlignment.RIGHT_ALIGN
WarichuAlignment.FULLY_JUSTIFIED
WarichuAlignment.LEFT_JUSTIFIED
WarichuAlignment.CENTER_JUSTIFIED
WarichuAlignment.RIGHT_JUSTIFIED
r/wThe warichu alignment.
warichuCharsAfterBreaknumber r/wThe minimum number of characters allowed after a line break.
warichuCharsBeforeBreaknumber r/wThe minimum number of characters allowed before a line break.
warichuLineSpacingnumber r/wThe gap between lines of warichu characters.
warichuLinesnumber r/wThe number of lines of warichu within a single normal line.
warichuSizenumber r/wThe amount (as a percentage) to scale parent text size to determine warichu size.
xOffsetDiacriticnumber r/wThe x (horizontal) offset for diacritic adjustment.
yOffsetDiacriticnumber r/wThe y (vertical) offset for diacritic adjustment.

Methods

Instances

EventListener addEventListener (eventType: string, handler: varies[, captures: bool=false])
Adds an event listener.

ParameterTypeDescription
eventTypestringThe event type.
handlerFile
JavaScript Function
The event handler. Can accept: File or JavaScript Function.
capturesboolThis parameter is obsolete. (Optional) (default: false)

void convertBulletsAndNumberingToText ()
Convert bullets and numbering to text.

ParagraphStyle duplicate ()
Duplicates the ParagraphStyle.

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

ParameterTypeDescription
keystringThe key.

Array of ParagraphStyle 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.

ParagraphStyle move (to: LocationOptions[, reference: varies])
Moves the style 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.
referenceApplication
CellStyle
CellStyleGroup
CharacterStyle
CharacterStyleGroup
Document
ParagraphStyle
ParagraphStyleGroup
TableStyle
TableStyleGroup
The reference object. Note: Required when the to parameter specifies before or after. Can accept: ParagraphStyle, ParagraphStyleGroup, CharacterStyle, CharacterStyleGroup, CellStyle, CellStyleGroup, TableStyle, TableStyleGroup, Document or Application. (Optional)

void remove ([replacingWith: ParagraphStyle])
Deletes the style.

ParameterTypeDescription
replacingWithParagraphStyleThe style to apply in place of the deleted style. (Optional)

bool removeEventListener (eventType: string, handler: varies[, captures: bool=false])
Removes the event listener.

ParameterTypeDescription
eventTypestringThe registered event type.
handlerFile
JavaScript Function
The registered event handler. Can accept: File or JavaScript Function.
capturesboolThis parameter is obsolete. (Optional) (default: false)

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

string toSpecifier ()
Retrieves the object specifier.

Element of

AnchoredObjectDefault.anchoredParagraphStyle

Application.allParagraphStyles

CellStyle.appliedParagraphStyle

ChangeGrepPreference.appliedParagraphStyle

ChangeTextPreference.appliedParagraphStyle

ChangeTransliteratePreference.appliedParagraphStyle

Character.appliedParagraphStyle

Document.allParagraphStyles

FindGrepPreference.appliedParagraphStyle

FindTextPreference.appliedParagraphStyle

FindTransliteratePreference.appliedParagraphStyle

FootnoteOption.footnoteTextStyle

InsertionPoint.appliedParagraphStyle

Line.appliedParagraphStyle

MatchParagraphStylePreference.appliedParagraphStyle

Paragraph.appliedParagraphStyle

ParagraphStyle.basedOn

ParagraphStyle.nextStyle

ParagraphStyleGroup.allParagraphStyles

Story.appliedParagraphStyle

StyleExportTagMap.parent

Text.appliedParagraphStyle

TextColumn.appliedParagraphStyle

TextDefault.appliedParagraphStyle

TextStyleRange.appliedParagraphStyle

Word.appliedParagraphStyle

XMLExportMap.mappedStyle

XMLImportMap.mappedStyle

XmlStory.appliedParagraphStyle

Used in:

void Character.applyParagraphStyle (using: ParagraphStyle[, clearingOverrides: bool=true])

void InsertionPoint.applyParagraphStyle (using: ParagraphStyle[, clearingOverrides: bool=true])

void Line.applyParagraphStyle (using: ParagraphStyle[, clearingOverrides: bool=true])

void Paragraph.applyParagraphStyle (using: ParagraphStyle[, clearingOverrides: bool=true])

void ParagraphStyle.remove ([replacingWith: ParagraphStyle])

ParagraphStyle ParagraphStyles.nextItem (obj: ParagraphStyle)

ParagraphStyle ParagraphStyles.previousItem (obj: ParagraphStyle)

void Text.applyParagraphStyle (using: ParagraphStyle[, clearingOverrides: bool=true])

void TextColumn.applyParagraphStyle (using: ParagraphStyle[, clearingOverrides: bool=true])

void TextStyleRange.applyParagraphStyle (using: ParagraphStyle[, clearingOverrides: bool=true])

void Word.applyParagraphStyle (using: ParagraphStyle[, clearingOverrides: bool=true])

Return

ParagraphStyle ParagraphStyle.duplicate ()

Array of ParagraphStyle ParagraphStyle.getElements ()

ParagraphStyle ParagraphStyle.move (to: LocationOptions[, reference: varies])

ParagraphStyle ParagraphStyles.[] (index: number)

ParagraphStyle ParagraphStyles.add ([withProperties: Object])

ParagraphStyle ParagraphStyles.anyItem ()

Array of ParagraphStyle ParagraphStyles.everyItem ()

ParagraphStyle ParagraphStyles.firstItem ()

ParagraphStyle ParagraphStyles.item (index: varies)

ParagraphStyle ParagraphStyles.itemByID (id: number)

ParagraphStyle ParagraphStyles.itemByName (name: string)

Array of ParagraphStyle ParagraphStyles.itemByRange (from: varies, to: varies)

ParagraphStyle ParagraphStyles.lastItem ()

ParagraphStyle ParagraphStyles.middleItem ()

ParagraphStyle ParagraphStyles.nextItem (obj: ParagraphStyle)

ParagraphStyle ParagraphStyles.previousItem (obj: ParagraphStyle)

Jongware, 29-Apr-2012 v3.0.3iContents :: Index