InDesign Server2025
API 20.5.0.49
Object

FindObjectPreference

Find object preferences.

Preference FindObjectPreference

Properties

NameType AccessDescription
Array | String | NothingEnum
read/write The metadata property to use as source of actual text. Can return: Ordered array containing namespacePrefix:String, propertyPath:String or NothingEnum enumerator.
SourceType | NothingEnum
read/write The source type of actual text. Can return: SourceType enumerator or NothingEnum enumerator.
Array | String | NothingEnum
read/write The metadata property to use as source of alternate text. Can return: Ordered array containing namespacePrefix:String, propertyPath:String or NothingEnum enumerator.
SourceType | NothingEnum
read/write The source type of alternate text. Can return: SourceType enumerator or NothingEnum enumerator.
AnchorPoint | NothingEnum
read/write The point in the anchored object to position. Can return: AnchorPoint enumerator or NothingEnum enumerator.
Unit | NothingEnum
read/write The space above an above-line anchored object. Can return: Unit or NothingEnum enumerator.
Unit | NothingEnum
read/write The horizontal (x) offset of the anchored object. Can return: Unit or NothingEnum enumerator.
Unit | NothingEnum
read/write The vertical (y) offset of the anchored object. Corresponds to the space after property for above line positioning. Can return: Unit or NothingEnum enumerator.
AnchorPosition | NothingEnum
read/write The position of the anchored object relative to the anchor. Can return: AnchorPosition enumerator or NothingEnum enumerator.
ObjectStyle | String | NothingEnum
read/write The applied object style(s). Can return: String or NothingEnum enumerator. Can also accept: ObjectStyle.
TagType | NothingEnum
read/write The tag type of page item. Can return: TagType enumerator or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, text wraps on the master spread apply to that spread only, and not to any pages the master spread has been applied to. Can return: Boolean or NothingEnum enumerator.
ArrowHeadAlignmentEnum | NothingEnum
read/write The arrowhead alignment applied to the FindObjectPreference. Can return: ArrowHeadAlignmentEnum enumerator or NothingEnum enumerator.
AutoSizingReferenceEnum | NothingEnum
read/write The reference point for auto sizing of text frame. Reference point is automatically adjusted to the suitable value depending on the auto-sizing type value. As an example, top left reference point becomes top center for height only dimension. Can return: AutoSizingReferenceEnum enumerator or NothingEnum enumerator.
AutoSizingTypeEnum | NothingEnum
read/write Auto-sizing type of text frame. Based on type, reference value is automatically adjusted. For example, for height only type, top-left reference point becomes top-center. Recommended to change auto-sizing type, after setting other auto-sizing attributes. Can return: AutoSizingTypeEnum enumerator or NothingEnum enumerator.
3 Reals (0 - 255)[] | NothingEnum[] | UIColors[]
read/write The grid line color, 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.
Unit(1-8640points) | NothingEnum
read/write The distance between grid lines. Can return: Unit (1 - 8640 points) or NothingEnum enumerator.
BaselineFrameGridRelativeOption | NothingEnum
read/write The location (top of page, top margin, top of frame, or frame inset) on which to base the custom baseline grid. Can return: BaselineFrameGridRelativeOption enumerator or NothingEnum enumerator.
Unit | NothingEnum
read/write The amount in measurement units to crop the bottom edge of a graphic. Can return: Unit or NothingEnum enumerator.
CornerOptions | NothingEnum
read/write The shape to apply to the bottom left corner of rectangular shapes. Can return: CornerOptions enumerator or NothingEnum enumerator.
Unit | NothingEnum
read/write The radius in measurement units of the corner effect applied to the bottom left corner of rectangular shapes. Can return: Unit or NothingEnum enumerator.
CornerOptions | NothingEnum
read/write The shape to apply to the bottom right corner of rectangular shapes. Can return: CornerOptions enumerator or NothingEnum enumerator.
Unit | NothingEnum
read/write The radius in measurement units of the corner effect applied to the bottom right corner of rectangular shapes. Can return: Unit or NothingEnum enumerator.
FindChangeContentTransparencySetting | NothingEnum
readonly Transparency settings for the content of the FindObjectPreference. Can return: FindChangeContentTransparencySetting or NothingEnum enumerator.
ContourOptionsTypes | NothingEnum
read/write The contour type. Can return: ContourOptionsTypes enumerator or NothingEnum enumerator.
String | NothingEnum
read/write The custom actual text entered by the user. Can return: String or NothingEnum enumerator.
String | NothingEnum
read/write The custom alternate text entered by the user. Can return: String or NothingEnum enumerator.
EndCap | NothingEnum
read/write The end shape of an open path. Can return: EndCap enumerator or NothingEnum enumerator.
EndJoin | NothingEnum
read/write The corner join applied to the FindObjectPreference. Can return: EndJoin enumerator or NothingEnum enumerator.
EventListeners<EventListener> readonly A collection of event listeners.
Events<Event> readonly A collection of events.
String | Swatch | NothingEnum
read/write The swatch (color, gradient, tint, or mixed ink) applied to the fill of the FindObjectPreference. . Can return: Swatch or NothingEnum enumerator. Can also accept: String.
Real | NothingEnum 0–100
read/write The percent of tint to use in the FindObjectPreference's fill color. (To specify a tint percent, 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.
FindChangeFillTransparencySetting | NothingEnum
readonly Transparency settings for the fill applied to the FindObjectPreference. Can return: FindChangeFillTransparencySetting or NothingEnum enumerator.
FirstBaseline | NothingEnum
read/write The distance between the baseline of the text and the top inset of the text frame or cell. Can return: FirstBaseline enumerator or NothingEnum enumerator.
AnchorPoint | NothingEnum
read/write The point with which to align the image empty when fitting in a frame. For information, see frame fitting options. Can return: AnchorPoint enumerator or NothingEnum enumerator.
EmptyFrameFittingOptions | NothingEnum
read/write The frame fitting option to apply to placed or pasted content if the frame is empty. Can be applied to a frame, object style, or document or to the application. Can return: EmptyFrameFittingOptions enumerator or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, enable overrides to document footnote options. Can return: Boolean or NothingEnum enumerator.
Unit(0-8640points) | NothingEnum
read/write Minimum Spacing Before First Footnote. Can return: Unit (0 - 8640 points) or NothingEnum enumerator.
Unit(0-8640points) | NothingEnum
read/write Space between footnotes. Can return: Unit (0 - 8640 points) or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, enable straddling footnotes. Can return: Boolean or NothingEnum enumerator.
FrameTypes | NothingEnum
read/write The type of text frame. Can return: FrameTypes enumerator or NothingEnum enumerator.
Swatch | NothingEnum
read/write The swatch (color, gradient, tint, or mixed ink) applied to the gap of a dashed, dotted, or striped stroke. For information, see stroke type. Can return: Swatch or NothingEnum enumerator.
Real | NothingEnum 0–100
read/write The tint as a percentage of the gap color. (To specify a tint percent, 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.
Boolean | NothingEnum
read/write If true, generates interlaced GIFs. Note: Not valid when image conversion is JPEG. Can return: Boolean or NothingEnum enumerator.
GIFOptionsPalette | NothingEnum
read/write The color palette for GIF conversion. Note: Not valid when image conversion is JPEG. . Can return: GIFOptionsPalette enumerator or NothingEnum enumerator.
Real | NothingEnum
read/write The angle of a linear gradient applied to the fill of the FindObjectPreference. (Range: -180 to 180). Can return: Real or NothingEnum enumerator.
Real | NothingEnum
read/write The angle of a linear gradient applied to the stroke of the FindObjectPreference. (Range: -180 to 180). Can return: Real or NothingEnum enumerator.
AnchoredRelativeTo | NothingEnum
read/write The horizontal reference point on the page. Valid only when anchored position is custom. Can return: AnchoredRelativeTo enumerator or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, ignores text wrap settings for drawn or placed objects in the text frame. . Can return: Boolean or NothingEnum enumerator.
ImageAlignmentType | NothingEnum
read/write Alignment applied to images. Can return: ImageAlignmentType enumerator or NothingEnum enumerator.
ImageFormat | NothingEnum
read/write Allows user to select the image format for conversion. Can return: ImageFormat enumerator or NothingEnum enumerator.
ImageResolution | NothingEnum
read/write The export resolution. Can return: ImageResolution enumerator or NothingEnum enumerator.
ImagePageBreakType | NothingEnum
read/write Image page break settings to be used with objects. Can return: ImagePageBreakType enumerator or NothingEnum enumerator.
Real(0-8640) | NothingEnum
read/write Space After applied to images. Can return: Real (0 - 8640) or NothingEnum enumerator.
Real(0-8640) | NothingEnum
read/write Space Before applied to images. Can return: Real (0 - 8640) or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, creates interior clipping paths within the surrounding clipping path. Note: Valid only when clipping type is alpha channel or detect edges. . Can return: Boolean or NothingEnum enumerator.
4 Units (0 - 8640 points)[] | Unit(0-8640points)[] | NothingEnum[]
read/write The amount to offset text from the edges of the text frame, specified either as a single value applied uniformly to all sides of the text frame or as an array of 4 values in the format [top inset, left inset, bottom inset, right inset]. Can return: Unit (0 - 8640 points), Array of 4 Units (0 - 8640 points) or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, inverts the text wrap. Can return: Boolean or NothingEnum enumerator.
Boolean readonly Returns true if the object specifier resolves to valid objects.
JPEGOptionsFormat | NothingEnum
read/write The formatting method for converted JPEG images. Note: Not valid when image conversion is GIF. Can return: JPEGOptionsFormat enumerator or NothingEnum enumerator.
JPEGOptionsQuality | NothingEnum
read/write The quality of converted JPEG images. Note: Not valid when image conversion is GIF. . Can return: JPEGOptionsQuality enumerator or NothingEnum enumerator.
Real | NothingEnum 1–1000
read/write The scaling applied to the arrowhead at the start of the path. (Range: 1 to 1000). Can return: Real or NothingEnum enumerator.
Unit | NothingEnum
read/write The amount in measurement units to crop the left edge of a graphic. Can return: Unit or NothingEnum enumerator.
ArrowHead | NothingEnum
read/write The arrowhead applied to the start of the path. . Can return: ArrowHead enumerator or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, prevents manual positioning of the anchored object. Can return: Boolean or NothingEnum enumerator.
Unit(0-8640points) | NothingEnum
read/write The minimum distance between the baseline of the text and the top inset of the text frame or cell. Can return: Unit (0 - 8640 points) or NothingEnum enumerator.
Unit | NothingEnum
read/write The minimum height for auto-sizing of the text frame. Can return: Unit or NothingEnum enumerator.
Unit | NothingEnum
read/write The minimum width for auto-sizing of the text frame. Can return: Unit or NothingEnum enumerator.
Real(1-500) | NothingEnum = 4
read/write The limit of the ratio of stroke width to miter length before a miter (pointed) join becomes a bevel (squared-off) join. Can return: Real (1 - 500) or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, the FindObjectPreference does not print. Can return: Boolean or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, adjust the position of characters at the edges of the frame to provide a better appearance. Can return: Boolean or NothingEnum enumerator.
Unit(01-1296points) | NothingEnum
read/write The point size used as the basis for calculating optical margin alignment. (Range: 0.1 to 1296). Can return: Unit (0.1 - 1296 points) or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, the FindObjectPreference's fill color overprints any underlying objects. If false, the fill color knocks out the underlying colors. Can return: Boolean or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, the gap color overprints any underlying colors. If false, the gap color knocks out the underlying colors. Can return: Boolean or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, the FindObjectPreference's stroke color overprints any underlying objects. If false, the stroke color knocks out the underlying colors. Can return: Boolean or NothingEnum enumerator.
Application readonly The parent of the FindObjectPreference (a Application).
Boolean | NothingEnum
read/write If true, pins the position of the anchored object within the text frame top and bottom. Can return: Boolean or NothingEnum enumerator.
AnchorPoint | NothingEnum
read/write The point in the referenced object relative to which to position the anchored object. Notes: Valid only when anchored position is custom. Can return: AnchorPoint enumerator or NothingEnum enumerator.
Preferences<Preference> readonly A collection of preferences objects.
PreserveAppearanceFromLayoutEnum | NothingEnum
read/write Preserve Appearance from Layout. Can return: PreserveAppearanceFromLayoutEnum enumerator or NothingEnum enumerator.
Object read/write A property that allows setting of several properties at the same time.
Real | NothingEnum 1–1000
read/write The scaling applied to the arrowhead at the end of the path. (Range: 1 to 1000). Can return: Real or NothingEnum enumerator.
Unit | NothingEnum
read/write The amount in measurement units to crop the right edge of a graphic. Can return: Unit or NothingEnum enumerator.
ArrowHead | NothingEnum
read/write The arrowhead applied to the end of the path. Can return: ArrowHead enumerator or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, the position of the anchored object is relative to the binding spine of the page or spread. Can return: Boolean or NothingEnum enumerator.
Unit(0-8640points) | NothingEnum
read/write The amount to offset the baseline grid. Can return: Unit (0 - 8640 points) or NothingEnum enumerator.
StoryDirectionOptions | NothingEnum
read/write The direction of the story. Can return: StoryDirectionOptions enumerator or NothingEnum enumerator.
StoryHorizontalOrVertical | NothingEnum
read/write The orientation of the text in the story. Can return: StoryHorizontalOrVertical enumerator or NothingEnum enumerator.
StrokeAlignment | NothingEnum
read/write The stroke alignment applied to the FindObjectPreference. Can return: StrokeAlignment enumerator or NothingEnum enumerator.
String | Swatch | NothingEnum
read/write The swatch (color, gradient, tint, or mixed ink) applied to the stroke of the FindObjectPreference. Can return: Swatch or NothingEnum enumerator. Can also accept: String.
StrokeCornerAdjustment | NothingEnum
read/write The corner adjustment applied to the FindObjectPreference. Can return: StrokeCornerAdjustment enumerator or NothingEnum enumerator.
Units[] | NothingEnum[]
read/write The dash and gap measurements that define the pattern of a custom dashed line. Define up to six values (in points) in the format [dash1, gap1, dash2, gap2, dash3, gap3]. Can return: Array of Units or NothingEnum enumerator.
Real | NothingEnum 0–100
read/write The percent of tint to use in object's stroke color. (To specify a tint percent, 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.
FindChangeStrokeTransparencySetting | NothingEnum
readonly Transparency settings for the stroke. Can return: FindChangeStrokeTransparencySetting or NothingEnum enumerator.
String | StrokeStyle | NothingEnum
read/write The name of the stroke style to apply. Can return: StrokeStyle or NothingEnum enumerator. Can also accept: String.
Unit | NothingEnum
read/write The weight (in points) to apply to the FindObjectPreference's stroke. Can return: Unit or NothingEnum enumerator.
LongInteger(1-40) | NothingEnum
read/write The number of columns in the text frame. Note: Depending on the value of use fixed column width, the number of columns can change automatically when the text frame size changes. Can return: Long Integer (1 - 40) or NothingEnum enumerator.
Unit(0-8640points) | NothingEnum
read/write The column width of the columns in the text frame. Can return: Unit (0 - 8640 points) or NothingEnum enumerator.
Unit(0-8640points) | NothingEnum
read/write The space between columns in the text frame. Can return: Unit (0 - 8640 points) or NothingEnum enumerator.
TextWrapModes | NothingEnum
read/write The text wrap mode. . Can return: TextWrapModes enumerator or NothingEnum enumerator.
Array | Unit | Unit | Unit | NothingEnum
read/write The minimum space between text and the edges of the wrapped object. Specify four values in the format [top, left, bottom, right]. . Can return: Ordered array containing top:Unit, left:Unit, bottom:Unit, right:Unit or NothingEnum enumerator.
TextWrapSideOptions | NothingEnum
read/write Text wrap side options. Can return: TextWrapSideOptions enumerator or NothingEnum enumerator.
Unit | NothingEnum
read/write The amount in measurement units to crop the top edge of a graphic. Can return: Unit or NothingEnum enumerator.
CornerOptions | NothingEnum
read/write The shape to be applied to the top left corner of rectangular shapes and all corners of non-rectangular shapes.Note: corner option differs from end join in which you can set a radius for a corner option, whereas the rounded or beveled effect of an end join depends on the stroke weight. Can return: CornerOptions enumerator or NothingEnum enumerator.
Unit | NothingEnum
read/write The radius in measurement units of the corner effect applied to the top left corner of rectangular shapes and all corners of non-rectangular shapes. Can return: Unit or NothingEnum enumerator.
CornerOptions | NothingEnum
read/write The shape to apply to the top right corner of rectangular shapes. Can return: CornerOptions enumerator or NothingEnum enumerator.
Unit | NothingEnum
read/write The radius in measurement units of the corner effect applied to the top right corner of rectangular shapes. Can return: Unit or NothingEnum enumerator.
FindChangeTransparencySetting | NothingEnum
readonly Transparency settings. Can return: FindChangeTransparencySetting or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, uses a custom baseline frame grid. Can return: Boolean or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, maintains column width when the text frame is resized. If false, causes columns to resize when the text frame is resized. Note: When true, resizing the frame can change the number of columns in the frame. Can return: Boolean or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, image page break settings will be used in objects. Can return: Boolean or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, minimum height value is used during the auto-sizing of text frame. . Can return: Boolean or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, minimum width value is used during the auto-sizing of text frame. . Can return: Boolean or NothingEnum enumerator.
Boolean | NothingEnum
read/write If true, line-breaks are not introduced after auto sizing. . Can return: Boolean or NothingEnum enumerator.
Boolean | NothingEnum
readonly If true, the text wrap path has been explicitly modified by the user. Can return: Boolean or NothingEnum enumerator.
VerticalJustification | NothingEnum
read/write The vertical alignment of the text content. . Can return: VerticalJustification enumerator or NothingEnum enumerator.
VerticallyRelativeTo | NothingEnum
read/write The vertical reference point on the page. Valid when anchored position is custom. Can return: VerticallyRelativeTo enumerator or NothingEnum enumerator.
Unit(0-8640points) | NothingEnum
read/write The maximum amount of vertical space between two paragraphs. Note: Valid only when vertical justification is justified; the specified amount is applied in addition to the space before or space after values defined for the paragraph. Can return: Unit (0 - 8640 points) or NothingEnum enumerator.

Methods

String

Provides the actual text for the object

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.
String

Provides the alternate text for the object

FindObjectPreference[]

Resolves the object specifier, creating an array of object references.

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 FindObjectPreference.

String

Retrieves the object specifier.

Object of 9

Properties elsewhere that hold a FindObjectPreference.

Return 1

Methods that return a FindObjectPreference.