InDesign Server2025
API 20.5.0.49
Object

MatchCharacterStylePreference

The preferences for a running header/footer (match character style) variable.

Preference MatchCharacterStylePreference
Hierarchy

TextVariable

MatchCharacterStylePreference

Properties

NameType AccessDescription
CharacterStyle | String read/write The character style applied to the text. Can also accept: String.
ChangeCaseOptions
read/write The case of the matched text.
Boolean read/write If true, deletes end punctuation from the matched text.
EventListeners<EventListener> readonly A collection of event listeners.
Events<Event> readonly A collection of events.
Boolean readonly Returns true if the object specifier resolves to valid objects.
TextVariable readonly The parent of the MatchCharacterStylePreference (a TextVariable).
Object read/write A property that allows setting of several properties at the same time.
SearchStrategies
read/write The starting point and direction in which the search will be conducted.
String read/write The text that follows the value of the variable. (Limit: 128 characters)
String read/write The text that precedes the value of the variable. (Limit: 128 characters)

Methods

EventListener

Adds an event listener.

eventType String The event type.
handler File | JavaScriptFunction The event handler. Can accept: File or JavaScript Function.
captures? Boolean This parameter is obsolete.
Boolean

Removes the event listener.

eventType String The registered event type.
handler File | JavaScriptFunction The registered event handler. Can accept: File or JavaScript Function.
captures? Boolean This parameter is obsolete.
String

Generates a string which, if executed, will return the MatchCharacterStylePreference.

String

Retrieves the object specifier.

Object of 4

Properties elsewhere that hold a MatchCharacterStylePreference.

Return 1

Methods that return a MatchCharacterStylePreference.