A collection of character styles.
character style Properties
| Property | Type | Access | Description |
|---|---|---|---|
| applied font | anything | 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 nothing. |
| applied language | anything | r/w | The language of the text. Can return: language with vendors, language or nothing. Can also accept: string. |
| based on | anything | r/w | The object that the character style is based on. Can return: character style, string or nothing. |
| baseline shift | anything | r/w | The baseline shift applied to the text. Can return: number or string or nothing. |
| capitalization | anything | r/w | The capitalization scheme. Can return: normal/small caps/all caps/cap to small cap or nothing. |
| class | anything | read | The class descriptor type. Can return: integer or nothing. |
| fill color | anything | r/w | The swatch (color, gradient, tint, or mixed ink) applied to the fill of the character style. . Can return: swatch or nothing. Can also accept: string. |
| fill tint | anything | r/w | The tint (as a percentage) of the fill color of the character style. (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: fixed or nothing. |
| font style | anything | r/w | The name of the font style. Can return: string or nothing. |
| gradient fill angle | anything | r/w | The angle of a linear gradient applied to the fill of the character style. (Range: -180 to 180). Can return: fixed or nothing. |
| gradient fill length | anything | r/w | The length (for a linear gradient) or radius (for a radial gradient) applied to the fill of the character style. Can return: fixed or nothing. |
| gradient fill start | anything | r/w | The starting point (in page coordinates) of a gradient applied to the fill of the character style, in the format [x, y]. Can return: list of 2 numbers or strings or nothing. |
| gradient stroke angle | anything | r/w | The angle of a linear gradient applied to the stroke of the character style. (Range: -180 to 180). Can return: fixed or nothing. |
| gradient stroke length | anything | r/w | The length (for a linear gradient) or radius (for a radial gradient) applied to the stroke of the character style. Can return: fixed or nothing. |
| gradient stroke start | anything | r/w | The starting point (in page coordinates) of a gradient applied to the stroke of the character style, in the format [x, y]. Can return: list of 2 numbers or strings or nothing. |
| horizontal scale | anything | r/w | The horizontal scaling applied to the text as a percentage of its current size. (Range: 1 to 1000). Can return: fixed or nothing. |
| id | anything | read | The unique ID of the character style. Can return: integer or nothing. |
| imported | anything | read | If true, the style was imported from another document. Can return: boolean or nothing. |
| index | anything | read | The index of the character style within its containing object. Can return: integer or nothing. |
| kerning method | anything | r/w | The type of pair kerning. Can return: string or nothing. |
| label | anything | r/w | A property that can be set to any string. Can return: string or nothing. |
| leading | anything | r/w | The leading applied to the text. Can return: number or string, auto or nothing. |
| ligatures | anything | r/w | If true, replaces specific character combinations (e.g., fl, fi) with ligature characters. Can return: boolean or nothing. |
| name | anything | r/w | The name of the character style. Can return: string or nothing. |
| no break | anything | r/w | If true, keeps the text on the same line. . Can return: boolean or nothing. |
| object reference | anything | read | An object reference for the character style. Can return: character style or nothing. |
| OTF contextual alternate | anything | r/w | If true, uses contextual alternate forms in OpenType fonts. Can return: boolean or nothing. |
| OTF discretionary ligature | anything | r/w | If true, uses discretionary ligatures in OpenType fonts. Can return: boolean or nothing. |
| OTF figure style | anything | r/w | The figure style in OpenType fonts. Can return: tabular lining/proportional oldstyle/proportional lining/tabular oldstyle/default or nothing. |
| OTF fraction | anything | r/w | If true, uses fractions in OpenType fonts. Can return: boolean or nothing. |
| OTF historical | anything | r/w | If true, use historical forms in OpenType fonts. Can return: boolean or nothing. |
| OTF locale | anything | r/w | If true, uses localized forms in OpenType fonts. Can return: boolean or nothing. |
| OTF mark | anything | r/w | If true, uses mark positioning in OpenType fonts. Can return: boolean or nothing. |
| OTF ordinal | anything | r/w | If true, uses ordinals in OpenType fonts. Can return: boolean or nothing. |
| OTF slashed zero | anything | r/w | If true, use a slashed zeroes in OpenType fonts. Can return: boolean or nothing. |
| OTF stylistic sets | anything | r/w | The stylistic sets to use in OpenType fonts. Can return: integer or nothing. |
| OTF swash | anything | r/w | If true, uses swash forms in OpenType fonts. Can return: boolean or nothing. |
| OTF titling | anything | r/w | If true, uses titling forms in OpenType fonts. Can return: boolean or nothing. |
| overprint fill | anything | r/w | If true, the fill color of the characters will overprint. Can return: boolean or nothing. |
| overprint stroke | anything | r/w | If true, the stroke of the characters will overprint. Can return: boolean or nothing. |
| parent | anything | read | The parent of the character style (a document, application or character style group). Can return: document, application, character style group or nothing. |
| point size | anything | r/w | The text size. Can return: number or string or nothing. |
| position | anything | r/w | The text position relative to the baseline. Can return: normal/superscript/subscript/OT superscript/OT subscript/OT numerator/OT denominator or nothing. |
| positional form | anything | r/w | The OpenType positional form. Can return: none/calculate/initial/medial/final/isolated or nothing. |
| properties | record | r/w | A property that allows setting of several properties at the same time. |
| skew | anything | r/w | The skew angle of the text. (Range: -85 to 85). Can return: fixed or nothing. |
| strike through color | anything | r/w | The swatch (color, gradient, tint, or mixed ink) applied to the strikethrough stroke. Can return: swatch, string or nothing. |
| strike through gap color | anything | r/w | The swatch (color, gradient, tint, or mixed ink) applied to the gap of the strikethrough stroke. Can return: swatch, string or nothing. |
| strike through gap overprint | anything | 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 nothing. |
| strike through gap tint | anything | 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: fixed or nothing. |
| strike through offset | anything | r/w | The amount by which to offset the strikethrough stroke from the text baseline. Can return: number or string or nothing. |
| strike through overprint | anything | r/w | If true, the strikethrough stroke will overprint. Can return: boolean or nothing. |
| strike through tint | anything | r/w | The tint (as a percentage) of the strikethrough stroke. (Range: 0 to 100). Can return: fixed or nothing. |
| strike through type | anything | r/w | The stroke type of the strikethrough stroke. Can return: stroke style, string or nothing. |
| strike through weight | anything | r/w | The stroke weight of the strikethrough stroke. Can return: number or string or nothing. |
| strike thru | anything | r/w | If true, draws a strikethrough line through the text. Can return: boolean or nothing. |
| stroke color | anything | r/w | The swatch (color, gradient, tint, or mixed ink) applied to the stroke of the character style. Can return: swatch or nothing. Can also accept: string. |
| stroke tint | anything | r/w | The tint (as a percentage) of the stroke color of the character style. (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: fixed or nothing. |
| stroke weight | anything | r/w | The stroke weight applied to the characters of the text. Can return: number or string or nothing. |
| tracking | anything | r/w | The amount by which to loosen or tighten a block of text, specified in thousands of an em. Can return: fixed or nothing. |
| underline | anything | r/w | If true, underlines the text. Can return: boolean or nothing. |
| underline color | anything | r/w | The swatch (color, gradient, tint, or mixed ink) applied to the underline stroke. . Can return: swatch, string or nothing. |
| underline gap color | anything | 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 nothing. |
| underline gap overprint | anything | r/w | If true, the gap color of the underline stroke will overprint. Can return: boolean or nothing. |
| underline gap tint | anything | 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: fixed or nothing. |
| underline offset | anything | r/w | The amount by which to offset the underline from the text baseline. Can return: number or string or nothing. |
| underline overprint | anything | r/w | If true, the underline stroke color will overprint. Can return: boolean or nothing. |
| underline tint | anything | r/w | The underline stroke tint (as a percentage). (Range: 0 to 100). Can return: fixed or nothing. |
| underline type | anything | r/w | The stroke type of the underline stroke. Can return: stroke style, string or nothing. |
| underline weight | anything | r/w | The stroke weight of the underline stroke. Can return: number or string or nothing. |
| vertical scale | anything | r/w | The vertical scaling applied to the text as a percentage of its current size. (Range: 1 to 1000). Can return: fixed or nothing. |