Indesign Scripting Reference
home | search | Links
JavaScript >> ChangePreference

ChangePreference

The change preferences.

ChangePreference Properties

Property Type Access Description
alignToBaseline Boolean r/w If true, align the baseline to the baseline grid.
appliedCharacterStyle String, CharacterStyle r/w The character style applied to the object.
appliedFont Font, String r/w The applied font. Either a font object or the name of font family.
appliedLanguage String, Language, LanguageWithVendors r/w The language dictionary appled to the object.
appliedParagraphStyle String, ParagraphStyle r/w The applied paragraph style.
autoLeading Real r/w Percentage used for calculating auto leading.
balanceRaggedLines Boolean, BalanceLinesStyle enumeration r/w If true, or set to one of the enumerations, apply ragged line balancing to the paragraph containing the object.
baselineShift Unit r/w The amount of baseline shift applied to the object.
bulletChar Bullet r/w The bullet character used when a bullet is applied to the paragraph containing the object.
bulletsAndNumberingColor AutoEnum enumeration, Swatch, String r/w The color of the bullet or numbering.
bulletsAndNumberingListType ListType enumeration r/w The list type to use for bullets and numbering.
bulletsAndNumberingSize AutoEnum enumeration, Real r/w The point size of the bullet or numbering.
capitalization Capitalization enumeration r/w The capitalization applied to the object.
changeText String r/w The replacement text.
composer String r/w The applied text composer.
dropCapCharacters Short r/w The number of characters for a drop cap.
dropCapLines Short r/w The number of lines for drop cap.
fillColor String, Swatch r/w The fill of the object.
fillTint Real r/w The tint percentage applied to the fill of the object (-1 indicates 100%).
firstLineIndent Unit r/w The first line indent.
fontStyle String r/w The name of the applied font style.
gradientFillAngle Real r/w The angle of the gradient applied to the fill of the object.
gradientFillLength Real r/w Length (for a linear gradient) or radius (for a radial gradient) of the gradient applied to the fill of the object.
gradientFillStart Array of 2 Units r/w Starting point (for a linear gradient) or center point (for a radial gradient) of a gradient applied to the fill of the object.
gradientStrokeAngle Real r/w The angle of the gradient applied to the stroke of the object.
gradientStrokeLength Real r/w Length (for a linear gradient) or radius (for a radial gradient) of the gradient applied to the stroke of the object.
gradientStrokeStart Array of 2 Units r/w Starting point (for a linear gradient) or center point (for a radial gradient) of a gradient applied to the stroke of the object.
horizontalScale Real r/w The horizontal scaling percentage applied to the object, including the scaling applied to its containing object(s).
hyphenateLastWord Boolean r/w If true, allow hyphenation for the last word of the paragraph.
justification Justification enumeration r/w The alignment applied to the paragraph.
keepAllLinesTogether Boolean r/w If true, to keep all lines of the paragraph together.
keepFirstLines Short r/w If the paragraph has to break across text columns or text frames, do not leave fewer than this number of lines at the beginning of the paragraph.
keepLastLines Short r/w If the paragraph has to break across text columns or text frames, do not leave fewer than this number of lines at the end of the paragraph.
keepLinesTogether Boolean r/w If true, use the settings for KeepAllLinesTogether, KeepFirstLines, and KeepLastLines.
keepWithNext Short r/w If this value is set to zero, allow a page break, column break, or frame break between this paragraph and the following paragraph. If the paragraph following this paragraph has to break across text columns or text frames, keep this paragraph with at least this number of lines of the following paragraph.
kerningMethod String r/w The type of kerning (Optical, Metrics or None).
kerningValue Real r/w The amount of kerning.
lastLineIndent Unit r/w The last line indent.
leading Unit, Leading enumeration r/w The applied leading.
leftIndent Unit r/w The left indent.
ligatures Boolean r/w If true, use automatic ligature replacement characters.
noBreak Boolean r/w If true, do not break the text across lines.
numberingFont Font, String, AutoEnum enumeration r/w The font applied to numbering.
numberingFontStyle String, NothingEnum enumeration, AutoEnum enumeration r/w The font style applied to numbering.
numberingStyle NumberingStyle enumeration, String r/w The numbering style.
numberSeparator Short r/w The numbering separator character.
numberStartAt Long r/w The starting number for a numbered list.
otfContextualAlternate Boolean r/w If true, use contextual alternate forms in OpenType fonts.
otfDiscretionaryLigature Boolean r/w If true, use discretionary ligatures in OpenType fonts.
otfFigureStyle OTFFigureStyle enumeration r/w The figure style to use in OpenType fonts.
otfFraction Boolean r/w If true, use fractions in OpenType fonts.
otfHistorical Boolean r/w If true, use historical forms in OpenType fonts.
otfOrdinal Boolean r/w If true, use ordinals in OpenType fonts.
otfSlashedZero Boolean r/w If true, use a zero with slash in OpenType fonts.
otfStylisticSets Long r/w Stylistic sets to use in OpenType fonts.
otfSwash Boolean r/w If true, use swash forms in OpenType fonts.
otfTitling Boolean r/w If true, use titling forms in OpenType fonts.
overprintFill Boolean r/w If true, the fill of the object will overprint.
overprintStroke Boolean r/w If true, the storke of the object will overprint.
parent Object read The parent of the object.
pointSize Unit r/w The point size of the text.
position Position enumeration r/w The position (e.g., superscript or subscript) of the object.
properties An array of property names and values r/w Property that allows setting of several properties at the same time.
rightIndent Unit r/w The right indent.
singleWordJustification SingleWordJustification enumeration r/w Alignment applied to lines containing a single word.
skew Real r/w The skew angle applied to the text.
spaceAfter Unit r/w Paragraph space after.
spaceBefore Unit r/w Paragraph space before.
startParagraph StartParagraph enumeration r/w When this property is set to anything other than start anywhere, apply a column or page break before the paragraph.
strikeThroughColor Swatch, String r/w The color of the strikethrough.
strikeThroughGapColor Swatch, String r/w The gap color of the strikethrough.
strikeThroughGapOverprint Boolean r/w If true, overprint the gap of the strikethrough.
strikeThroughGapTint Real r/w The tint percentage applied to the gap of the strikethrough (-1 represents 100%).
strikeThroughOffset Unit r/w The offset of the strikethrough from the baseline.
strikeThroughOverprint Boolean r/w If true, overprint the strikethrough.
strikeThroughTint Real r/w The tint percentage applied to stroke color of the strikethrough.
strikeThroughType StrokeStyle, String r/w The stroke style of the strikethrough.
strikeThroughWeight Unit r/w The stroke weight of the strikethrough.
strikeThru Boolean r/w If true, apply a strikethrough to the text.
strokeColor String, Swatch r/w The stroke color of the object.
strokeTint Real r/w The tint percentage applied to the stroke (-1 indicates 100%).
strokeWeight Unit r/w The stroke weight (thickness) of the stroke.
tracking Real r/w The tracking (range kerning) applied to the object.
underline Boolean r/w If true, apply an underline to the text.
underlineColor Swatch, String r/w The color of the underline.
underlineGapColor Swatch, String r/w The gap color of the underline.
underlineGapOverprint Boolean r/w If true, overprint the gap of the underline.
underlineGapTint Real r/w The tint percentage applied to the gap of the underline (-1 represents 100%).
underlineOffset Unit r/w The offset of the underline from the baseline.
underlineOverprint Boolean r/w If true, overprint the underline.
underlineTint Real r/w The tint percentage applied to the underline (-1 represents 100%).
underlineType StrokeStyle, String r/w The stroke style applied to the underline.
underlineWeight Unit r/w The stroke weight of the underline.
verticalScale Real r/w The vertical scaling percentage applied to the object, including the scaling applied to its containing object(s).

ChangePreference Methods

Method Returns Description
getElements Array of Objects Resolve the object specifier.
toSource String Generate JavaScript source that, if executed, will return the specified objects.
toSpecifier String Retrieve the object specifier.