Class
Preferences for changing found text or attributes.
getElements, toSource, toSpecifier
ChangePreference
QuickLinks
Hierarchy
Properties
| Property | Type | Access | Description |
|---|---|---|---|
| alignToBaseline | Boolean NothingEnum |
r/w | If true, aligns the baseline of the text to the baseline grid. Can return: Boolean or NothingEnum enumerator. |
| appliedCharacterStyle | CharacterStyle NothingEnum String |
r/w | The character style to search for or change to. Can return: String or NothingEnum enumerator. Can also accept: CharacterStyle. |
| appliedFont | Font NothingEnum String |
r/w | The font applied to the text, specified as either a font object or the name of font family. Can return: Font, String or NothingEnum enumerator. |
| appliedLanguage | Language LanguageWithVendors NothingEnum String |
r/w | The language to search for or change to. Can return: String or NothingEnum enumerator. Can also accept: Language or LanguageWithVendors. |
| appliedParagraphStyle | NothingEnum ParagraphStyle String |
r/w | The paragraph style to search for or change to. Can return: String or NothingEnum enumerator. Can also accept: ParagraphStyle. |
| autoLeading | NothingEnum Real |
r/w | The percent of the type size to use for auto leading. (Range: 0 to 500). Can return: Real or NothingEnum enumerator. |
| balanceRaggedLines | BalanceLinesStyle Boolean NothingEnum |
r/w | If true or set to an enumeration value, balances ragged lines. Note: Not valid with a single-line text composer. Can return: Boolean, BalanceLinesStyle enumerator or NothingEnum enumerator. |
| baselineShift | NothingEnum Unit |
r/w | The baseline shift applied to the text. Can return: Unit or NothingEnum enumerator. |
| bulletChar | Bullet NothingEnum |
r/w | Bullet character. Can return: Bullet or NothingEnum enumerator. |
| bulletsAndNumberingColor | AutoEnum NothingEnum String Swatch |
r/w | Color of the bullet or number character. Can return: AutoEnum enumerator, Swatch, String or NothingEnum enumerator. |
| bulletsAndNumberingListType | ListType NothingEnum |
r/w | List type for bullets and numbering. Can return: ListType enumerator or NothingEnum enumerator. |
| bulletsAndNumberingSize | AutoEnum NothingEnum Real |
r/w | Point size of the bullet or number character. Can return: AutoEnum enumerator, Real or NothingEnum enumerator. |
| capitalization | Capitalization NothingEnum |
r/w | The capitalization scheme. Can return: Capitalization enumerator or NothingEnum enumerator. |
| changeText | NothingEnum String |
r/w | The text string with which to replace the found text. Can return: String or NothingEnum enumerator. |
| composer | NothingEnum String |
r/w | The text composer to use to compose the text. Can return: String or NothingEnum enumerator. |
| dropCapCharacters | NothingEnum Short |
r/w | Number of characters for drop cap. Can return: Short or NothingEnum enumerator. |
| dropCapLines | NothingEnum Short |
r/w | Number of lines for drop cap. Can return: Short or NothingEnum enumerator. |
| fillColor | NothingEnum String Swatch |
r/w | The swatch (color, gradient, tint, or mixed ink), applied as a fill color, to search for or change to. Can return: String or NothingEnum enumerator. Can also accept: Swatch. |
| fillTint | NothingEnum Real |
r/w | The 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.). Can return: Real or NothingEnum enumerator. |
| firstLineIndent | NothingEnum Unit |
r/w | The amount to indent the first line. Can return: Unit or NothingEnum enumerator. |
| fontStyle | NothingEnum String |
r/w | The name of the font style. Can return: String or NothingEnum enumerator. |
| gradientFillAngle | NothingEnum Real |
r/w | The angle of a linear gradient applied to the fill of the text. (Range: -180 to 180). Can return: Real or NothingEnum enumerator. |
| gradientFillLength | NothingEnum Real |
r/w | The length (for a linear gradient) or radius (for a radial gradient) applied to the fill of the text. Can return: Real or NothingEnum enumerator. |
| gradientFillStart | 2 Units NothingEnum |
r/w | The starting point (in page coordinates) of a gradient applied to the fill of the text, in the format [x, y]. Can return: Array of 2 Units or NothingEnum enumerator. |
| gradientStrokeAngle | NothingEnum Real |
r/w | The angle of a linear gradient applied to the stroke of the text. (Range: -180 to 180). Can return: Real or NothingEnum enumerator. |
| gradientStrokeLength | NothingEnum Real |
r/w | The length (for a linear gradient) or radius (for a radial gradient) applied to the stroke of the text. Can return: Real or NothingEnum enumerator. |
| gradientStrokeStart | 2 Units NothingEnum |
r/w | The starting point (in page coordinates) of a gradient applied to the stroke of the text, in the format [x, y]. Can return: Array of 2 Units or NothingEnum enumerator. |
| horizontalScale | NothingEnum Real |
r/w | The horizontal scaling applied to the text as a percentage of its current size. (Range: 1 to 1000). Can return: Real or NothingEnum enumerator. |
| hyphenateLastWord | Boolean NothingEnum |
r/w | If true, allows hyphenation in the last word in a paragraph. Note: Valid only when hyphenation is true. Can return: Boolean or NothingEnum enumerator. |
| justification | Justification NothingEnum |
r/w | The paragraph alignment. Can return: Justification enumerator or NothingEnum enumerator. |
| keepAllLinesTogether | Boolean NothingEnum |
r/w | If true, keeps all lines of the paragraph together. If false, allows paragraphs to break across pages or columns. Can return: Boolean or NothingEnum enumerator. |
| keepFirstLines | NothingEnum Short |
r/w | Keep at least this many lines together at the end of a column. Can return: Short or NothingEnum enumerator. |
| keepLastLines | NothingEnum Short |
r/w | Keep at least this many lines together at the start of a column. Can return: Short or NothingEnum enumerator. |
| keepLinesTogether | Boolean NothingEnum |
r/w | If true, keeps a specified number of lines together when the paragraph breaks across columns or text frames. Can return: Boolean or NothingEnum enumerator. |
| keepWithNext | NothingEnum Short |
r/w | Keep at least this many lines together with the following paragraph. Can return: Short or NothingEnum enumerator. |
| kerningMethod | NothingEnum String |
r/w | The type of pair kerning. Can return: String or NothingEnum enumerator. |
| kerningValue | NothingEnum Real |
r/w | The amount of space to add or remove between characters, specified in thousands of an em. . Can return: Real or NothingEnum enumerator. |
| lastLineIndent | NothingEnum Unit |
r/w | The amount to indent the last line in the paragraph. Can return: Unit or NothingEnum enumerator. |
| leading | Leading NothingEnum Unit |
r/w | The leading applied to the text. Can return: Unit, Leading enumerator or NothingEnum enumerator. |
| leftIndent | NothingEnum Unit |
r/w | The width of the left indent. Can return: Unit or NothingEnum enumerator. |
| ligatures | Boolean NothingEnum |
r/w | If true, replaces specific character combinations (e.g., fl, fi) with ligature characters. Can return: Boolean or NothingEnum enumerator. |
| noBreak | Boolean NothingEnum |
r/w | If true, keeps the text on the same line. . Can return: Boolean or NothingEnum enumerator. |
| numberSeparator | NothingEnum Short |
r/w | The numbering separator as a unicode ID. Can return: Short or NothingEnum enumerator. |
| numberStartAt | Long NothingEnum |
r/w | Starting number in a numbered list. Can return: Long or NothingEnum enumerator. |
| numberingFont | AutoEnum Font NothingEnum String |
r/w | Font of the number character. Can return: Font, String, AutoEnum enumerator or NothingEnum enumerator. |
| numberingFontStyle | AutoEnum NothingEnum String |
r/w | Font style of the number character. Can return: String, NothingEnum enumerator or AutoEnum enumerator. |
| numberingStyle | NothingEnum NumberingStyle String |
r/w | Numbering style. Can return: NumberingStyle enumerator, String or NothingEnum enumerator. |
| otfContextualAlternate | Boolean NothingEnum |
r/w | If true, uses contextual alternate forms in OpenType fonts. Can return: Boolean or NothingEnum enumerator. |
| otfDiscretionaryLigature | Boolean NothingEnum |
r/w | If true, uses discretionary ligatures in OpenType fonts. Can return: Boolean or NothingEnum enumerator. |
| otfFigureStyle | NothingEnum OTFFigureStyle |
r/w | The figure style in OpenType fonts. Can return: OTFFigureStyle enumerator or NothingEnum enumerator. |
| otfFraction | Boolean NothingEnum |
r/w | If true, uses fractions in OpenType fonts. Can return: Boolean or NothingEnum enumerator. |
| otfHistorical | Boolean NothingEnum |
r/w | If true, use historical forms in OpenType fonts. Can return: Boolean or NothingEnum enumerator. |
| otfOrdinal | Boolean NothingEnum |
r/w | If true, uses ordinals in OpenType fonts. Can return: Boolean or NothingEnum enumerator. |
| otfSlashedZero | Boolean NothingEnum |
r/w | If true, use a slashed zeroes in OpenType fonts. Can return: Boolean or NothingEnum enumerator. |
| otfStylisticSets | Long NothingEnum |
r/w | The stylistic sets to use in OpenType fonts. Can return: Long or NothingEnum enumerator. |
| otfSwash | Boolean NothingEnum |
r/w | If true, uses swash forms in OpenType fonts. Can return: Boolean or NothingEnum enumerator. |
| otfTitling | Boolean NothingEnum |
r/w | If true, uses titling forms in OpenType fonts. Can return: Boolean or NothingEnum enumerator. |
| overprintFill | Boolean NothingEnum |
r/w | If true, the fill color of the characters will overprint. Can return: Boolean or NothingEnum enumerator. |
| overprintStroke | Boolean NothingEnum |
r/w | If true, the stroke of the characters will overprint. Can return: Boolean or NothingEnum enumerator. |
| parent | Application | readonly | The parent of the ChangePreference (a Application). |
| pointSize | NothingEnum Unit |
r/w | The text size. Can return: Unit or NothingEnum enumerator. |
| position | NothingEnum Position |
r/w | The text position relative to the baseline. Can return: Position enumerator or NothingEnum enumerator. |
| properties | Object | r/w | A property that allows setting of several properties at the same time. |
| rightIndent | NothingEnum Unit |
r/w | The width of the right indent. Can return: Unit or NothingEnum enumerator. |
| singleWordJustification | NothingEnum SingleWordJustification |
r/w | The alignment to use for lines that contain a single word. Can return: SingleWordJustification enumerator or NothingEnum enumerator. |
| skew | NothingEnum Real |
r/w | The skew angle of the text. (Range: -85 to 85). Can return: Real or NothingEnum enumerator. |
| spaceAfter | NothingEnum Unit |
r/w | The height of the paragraph space below. Can return: Unit or NothingEnum enumerator. |
| spaceBefore | NothingEnum Unit |
r/w | The height of the paragraph space above. Can return: Unit or NothingEnum enumerator. |
| startParagraph | NothingEnum StartParagraph |
r/w | The location at which to start the paragraph. Can return: StartParagraph enumerator or NothingEnum enumerator. |
| strikeThroughColor | NothingEnum String Swatch |
r/w | The swatch (color, gradient, tint, or mixed ink) applied to the strikethrough stroke. Can return: Swatch, String or NothingEnum enumerator. |
| strikeThroughGapColor | NothingEnum String Swatch |
r/w | The swatch (color, gradient, tint, or mixed ink) applied to the gap of the strikethrough stroke. Can return: Swatch, String or NothingEnum enumerator. |
| strikeThroughGapOverprint | Boolean NothingEnum |
r/w | If true, the gap color of the strikethrough stroke will overprint. Note: Valid when strike through type is not solid. Can return: Boolean or NothingEnum enumerator. |
| strikeThroughGapTint | NothingEnum Real |
r/w | The tint (as a percentage) of the strikethrough stroke gap color. (Range: 0 to 100) Note: Valid when strike through type is not solid. Can return: Real or NothingEnum enumerator. |
| strikeThroughOffset | NothingEnum Unit |
r/w | The amount by which to offset the strikethrough stroke from the text baseline. Can return: Unit or NothingEnum enumerator. |
| strikeThroughOverprint | Boolean NothingEnum |
r/w | If true, the strikethrough stroke will overprint. Can return: Boolean or NothingEnum enumerator. |
| strikeThroughTint | NothingEnum Real |
r/w | The tint (as a percentage) of the strikethrough stroke. (Range: 0 to 100). Can return: Real or NothingEnum enumerator. |
| strikeThroughType | NothingEnum String StrokeStyle |
r/w | The stroke type of the strikethrough stroke. Can return: StrokeStyle, String or NothingEnum enumerator. |
| strikeThroughWeight | NothingEnum Unit |
r/w | The stroke weight of the strikethrough stroke. Can return: Unit or NothingEnum enumerator. |
| strikeThru | Boolean NothingEnum |
r/w | If true, draws a strikethrough line through the text. Can return: Boolean or NothingEnum enumerator. |
| strokeColor | NothingEnum String Swatch |
r/w | The swatch (color, gradient, tint, or mixed ink), applied as a stroke color, to search for or change to. Can return: String or NothingEnum enumerator. Can also accept: Swatch. |
| strokeTint | NothingEnum Real |
r/w | The 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.). Can return: Real or NothingEnum enumerator. |
| strokeWeight | NothingEnum Unit |
r/w | The stroke weight applied to the characters of the text. Can return: Unit or NothingEnum enumerator. |
| tracking | NothingEnum Real |
r/w | The amount by which to loosen or tighten a block of text, specified in thousands of an em. Can return: Real or NothingEnum enumerator. |
| underline | Boolean NothingEnum |
r/w | If true, underlines the text. Can return: Boolean or NothingEnum enumerator. |
| underlineColor | NothingEnum String Swatch |
r/w | The swatch (color, gradient, tint, or mixed ink) applied to the underline stroke. . Can return: Swatch, String or NothingEnum enumerator. |
| underlineGapColor | NothingEnum String Swatch |
r/w | The 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, String or NothingEnum enumerator. |
| underlineGapOverprint | Boolean NothingEnum |
r/w | If true, the gap color of the underline stroke will overprint. Can return: Boolean or NothingEnum enumerator. |
| underlineGapTint | NothingEnum Real |
r/w | The tint (as a percentage) of the gap color of the underline stroke. (Range: 0 to 100) Note: Valid when underline type is not solid. Can return: Real or NothingEnum enumerator. |
| underlineOffset | NothingEnum Unit |
r/w | The amount by which to offset the underline from the text baseline. Can return: Unit or NothingEnum enumerator. |
| underlineOverprint | Boolean NothingEnum |
r/w | If true, the underline stroke color will overprint. Can return: Boolean or NothingEnum enumerator. |
| underlineTint | NothingEnum Real |
r/w | The underline stroke tint (as a percentage). (Range: 0 to 100). Can return: Real or NothingEnum enumerator. |
| underlineType | NothingEnum String StrokeStyle |
r/w | The stroke type of the underline stroke. Can return: StrokeStyle, String or NothingEnum enumerator. |
| underlineWeight | NothingEnum Unit |
r/w | The stroke weight of the underline stroke. Can return: Unit or NothingEnum enumerator. |
| verticalScale | NothingEnum Real |
r/w | The vertical scaling applied to the text as a percentage of its current size. (Range: 1 to 1000). Can return: Real or NothingEnum enumerator. |
Methods
Instances
Array
of Object getElements ()
Resolves the object specifier, creating an array of object references.
string toSource ()
Generates a string which, if executed, will return the ChangePreference.
Element of
Application.changePreferences
Bullet.parent
| Jongware, 27-Jun-2010 v3.0.3d | Contents :: Index |