ChangeObjectPreference
Change object preferences.
Go to Property Listing | Method Listing
Methods:
actualText, addEventListener, altText, getElements, removeEventListener, toSource, toSpecifier
Objects:
AnchorPoint, AnchorPosition, AnchoredRelativeTo, ArrowHead, ArrowHeadAlignmentEnum, AutoSizingReferenceEnum, AutoSizingTypeEnum, BaselineFrameGridRelativeOption, Boolean, ContourOptionsTypes, CornerOptions, EmptyFrameFittingOptions, EndCap, EndJoin, EventListeners, Events, FindChangeContentTransparencySetting, FindChangeFillTransparencySetting, FindChangeStrokeTransparencySetting, FindChangeTransparencySetting, FirstBaseline, GIFOptionsPalette, ImageAlignmentType, ImageFormat, ImagePageBreakType, ImageResolution, JPEGOptionsFormat, JPEGOptionsQuality, NothingEnum, Object, Preferences, PreserveAppearanceFromLayoutEnum, SourceType, StoryDirectionOptions, String, StrokeAlignment, StrokeCornerAdjustment, StrokeStyle, Swatch, TagType, TextWrapModes, TextWrapSideOptions, UIColors, VerticalJustification, VerticallyRelativeTo
Preferences:
Hierarchy:
Superclass: Preference
Class: ChangeObjectPreference
Property Listing
Property |
Type |
Access |
Description |
---|---|---|---|
OrderedarraycontainingnamespacePrefix:String PropertyPath:String |
read/write |
The metadata property to use as source of actual text. Can return: Ordered array containing namespacePrefix:String, propertyPath:String or NothingEnum enumerator. |
|
read/write |
The source type of actual text. Can return: SourceType enumerator or NothingEnum enumerator. |
||
OrderedarraycontainingnamespacePrefix:String PropertyPath:String |
read/write |
The metadata property to use as source of alternate text. Can return: Ordered array containing namespacePrefix:String, propertyPath:String or NothingEnum enumerator. |
|
read/write |
The source type of alternate text. Can return: SourceType enumerator or NothingEnum enumerator. |
||
read/write |
The point in the anchored object to position. Can return: AnchorPoint enumerator or NothingEnum enumerator. |
||
Unit |
read/write |
The space above an above-line anchored object. Can return: Unit or NothingEnum enumerator. |
|
Unit |
read/write |
The horizontal (x) offset of the anchored object. Can return: Unit or NothingEnum enumerator. |
|
Unit |
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. |
|
read/write |
The position of the anchored object relative to the anchor. Can return: AnchorPosition enumerator or NothingEnum enumerator. |
||
NothingEnumCanalsoaccept:ObjectStyle |
read/write |
The applied object style(s). Can return: String or NothingEnum enumerator. Can also accept: ObjectStyle. |
|
read/write |
The tag type of page item. Can return: TagType enumerator or NothingEnum enumerator. |
||
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. |
||
read/write |
The arrowhead alignment applied to the ChangeObjectPreference. Can return: ArrowHeadAlignmentEnum enumerator or NothingEnum enumerator. |
||
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. |
||
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. |
||
Array of 3 Reals (0 - 255) |
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) |
read/write |
The distance between grid lines. Can return: Unit (1 - 8640 points) or NothingEnum enumerator. |
|
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 |
read/write |
The amount in measurement units to crop the bottom edge of a graphic. Can return: Unit or NothingEnum enumerator. |
|
read/write |
The shape to apply to the bottom left corner of rectangular shapes. Can return: CornerOptions enumerator or NothingEnum enumerator. |
||
Unit |
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. |
|
read/write |
The shape to apply to the bottom right corner of rectangular shapes. Can return: CornerOptions enumerator or NothingEnum enumerator. |
||
Unit |
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. |
|
readonly |
Transparency settings for the content of the ChangeObjectPreference. Can return: FindChangeContentTransparencySetting or NothingEnum enumerator. |
||
read/write |
The contour type. Can return: ContourOptionsTypes enumerator or NothingEnum enumerator. |
||
read/write |
The custom actual text entered by the user. Can return: String or NothingEnum enumerator. |
||
read/write |
The custom alternate text entered by the user. Can return: String or NothingEnum enumerator. |
||
read/write |
The end shape of an open path. Can return: EndCap enumerator or NothingEnum enumerator. |
||
read/write |
The corner join applied to the ChangeObjectPreference. Can return: EndJoin enumerator or NothingEnum enumerator. |
||
readonly |
A collection of event listeners. |
||
readonly |
A collection of events. |
||
NothingEnumCanalsoaccept:String |
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the fill of the ChangeObjectPreference. . Can return: Swatch or NothingEnum enumerator. Can also accept: String. |
|
Real (range 0 - 100) |
read/write |
The percent of tint to use in the ChangeObjectPreference'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. |
|
readonly |
Transparency settings for the fill applied to the ChangeObjectPreference. Can return: FindChangeFillTransparencySetting or NothingEnum enumerator. |
||
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. |
||
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. |
||
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. |
||
read/write |
If true, enable overrides to document footnote options. Can return: Boolean or NothingEnum enumerator. |
||
Unit(0-8640points) |
read/write |
Minimum Spacing Before First Footnote. Can return: Unit (0 - 8640 points) or NothingEnum enumerator. |
|
Unit(0-8640points) |
read/write |
Space between footnotes. Can return: Unit (0 - 8640 points) or NothingEnum enumerator. |
|
read/write |
If true, enable straddling footnotes. Can return: Boolean or NothingEnum enumerator. |
||
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 (range 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. |
|
read/write |
If true, generates interlaced GIFs. Note: Not valid when image conversion is JPEG. Can return: Boolean or NothingEnum enumerator. |
||
read/write |
The color palette for GIF conversion. Note: Not valid when image conversion is JPEG. . Can return: GIFOptionsPalette enumerator or NothingEnum enumerator. |
||
Real |
read/write |
The angle of a linear gradient applied to the fill of the ChangeObjectPreference. (Range: -180 to 180). Can return: Real or NothingEnum enumerator. |
|
Real |
read/write |
The angle of a linear gradient applied to the stroke of the ChangeObjectPreference. (Range: -180 to 180). Can return: Real or NothingEnum enumerator. |
|
read/write |
The horizontal reference point on the page. Valid only when anchored position is custom. Can return: AnchoredRelativeTo enumerator or NothingEnum enumerator. |
||
read/write |
If true, ignores text wrap settings for drawn or placed objects in the text frame. . Can return: Boolean or NothingEnum enumerator. |
||
read/write |
Alignment applied to images. Can return: ImageAlignmentType enumerator or NothingEnum enumerator. |
||
read/write |
Allows user to select the image format for conversion. Can return: ImageFormat enumerator or NothingEnum enumerator. |
||
read/write |
The export resolution. Can return: ImageResolution enumerator or NothingEnum enumerator. |
||
read/write |
Image page break settings to be used with objects. Can return: ImagePageBreakType enumerator or NothingEnum enumerator. |
||
Real(0-8640) |
read/write |
Space After applied to images. Can return: Real (0 - 8640) or NothingEnum enumerator. |
|
Real(0-8640) |
read/write |
Space Before applied to images. Can return: Real (0 - 8640) or NothingEnum enumerator. |
|
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. |
||
Array of 4 Units (0 - 8640 points) Unit(0-8640points) |
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. |
|
read/write |
If true, inverts the text wrap. Can return: Boolean or NothingEnum enumerator. |
||
readonly |
Returns true if the object specifier resolves to valid objects. |
||
read/write |
The formatting method for converted JPEG images. Note: Not valid when image conversion is GIF. Can return: JPEGOptionsFormat enumerator or NothingEnum enumerator. |
||
read/write |
The quality of converted JPEG images. Note: Not valid when image conversion is GIF. . Can return: JPEGOptionsQuality enumerator or NothingEnum enumerator. |
||
Real (range 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 |
read/write |
The amount in measurement units to crop the left edge of a graphic. Can return: Unit or NothingEnum enumerator. |
|
read/write |
The arrowhead applied to the start of the path. . Can return: ArrowHead enumerator or NothingEnum enumerator. |
||
read/write |
If true, prevents manual positioning of the anchored object. Can return: Boolean or NothingEnum enumerator. |
||
Unit(0-8640points) |
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 |
read/write |
The minimum height for auto-sizing of the text frame. Can return: Unit or NothingEnum enumerator. |
|
Unit |
read/write |
The minimum width for auto-sizing of the text frame. Can return: Unit or NothingEnum enumerator. |
|
Real(1-500) |
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. |
|
read/write |
If true, the ChangeObjectPreference does not print. Can return: Boolean or NothingEnum enumerator. |
||
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) |
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. |
|
read/write |
If true, the ChangeObjectPreference's fill color overprints any underlying objects. If false, the fill color knocks out the underlying colors. Can return: Boolean or NothingEnum enumerator. |
||
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. |
||
read/write |
If true, the ChangeObjectPreference's stroke color overprints any underlying objects. If false, the stroke color knocks out the underlying colors. Can return: Boolean or NothingEnum enumerator. |
||
readonly |
The parent of the ChangeObjectPreference (a Application). |
||
read/write |
If true, pins the position of the anchored object within the text frame top and bottom. Can return: Boolean or NothingEnum enumerator. |
||
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. |
||
readonly |
A collection of preferences objects. |
||
read/write |
Preserve Appearance from Layout. Can return: PreserveAppearanceFromLayoutEnum enumerator or NothingEnum enumerator. |
||
read/write |
A property that allows setting of several properties at the same time. |
||
Real (range 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 |
read/write |
The amount in measurement units to crop the right edge of a graphic. Can return: Unit or NothingEnum enumerator. |
|
read/write |
The arrowhead applied to the end of the path. Can return: ArrowHead enumerator or NothingEnum enumerator. |
||
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) |
read/write |
The amount to offset the baseline grid. Can return: Unit (0 - 8640 points) or NothingEnum enumerator. |
|
read/write |
The direction of the story. Can return: StoryDirectionOptions enumerator or NothingEnum enumerator. |
||
read/write |
The stroke alignment applied to the ChangeObjectPreference. Can return: StrokeAlignment enumerator or NothingEnum enumerator. |
||
NothingEnumCanalsoaccept:String |
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the stroke of the ChangeObjectPreference. Can return: Swatch or NothingEnum enumerator. Can also accept: String. |
|
read/write |
The corner adjustment applied to the ChangeObjectPreference. Can return: StrokeCornerAdjustment enumerator or NothingEnum enumerator. |
||
Array of Units |
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 (range 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. |
|
readonly |
Transparency settings for the stroke. Can return: FindChangeStrokeTransparencySetting or NothingEnum enumerator. |
||
NothingEnumCanalsoaccept:String |
read/write |
The name of the stroke style to apply. Can return: StrokeStyle or NothingEnum enumerator. Can also accept: String. |
|
Unit |
read/write |
The weight (in points) to apply to the ChangeObjectPreference's stroke. Can return: Unit or NothingEnum enumerator. |
|
LongInteger(1-40) |
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) |
read/write |
The column width of the columns in the text frame. Can return: Unit (0 - 8640 points) or NothingEnum enumerator. |
|
Unit(0-8640points) |
read/write |
The space between columns in the text frame. Can return: Unit (0 - 8640 points) or NothingEnum enumerator. |
|
read/write |
The text wrap mode. . Can return: TextWrapModes enumerator or NothingEnum enumerator. |
||
Orderedarraycontainingtop:Unit Bottom:Unit Left:Unit Right:Unit |
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. |
|
read/write |
Text wrap side options. Can return: TextWrapSideOptions enumerator or NothingEnum enumerator. |
||
Unit |
read/write |
The amount in measurement units to crop the top edge of a graphic. Can return: Unit or NothingEnum enumerator. |
|
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 |
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. |
|
read/write |
The shape to apply to the top right corner of rectangular shapes. Can return: CornerOptions enumerator or NothingEnum enumerator. |
||
Unit |
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. |
|
readonly |
Transparency settings. Can return: FindChangeTransparencySetting or NothingEnum enumerator. |
||
read/write |
If true, uses a custom baseline frame grid. Can return: Boolean or NothingEnum enumerator. |
||
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. |
||
read/write |
If true, image page break settings will be used in objects. Can return: Boolean or NothingEnum enumerator. |
||
read/write |
If true, minimum height value is used during the auto-sizing of text frame. . Can return: Boolean or NothingEnum enumerator. |
||
read/write |
If true, minimum width value is used during the auto-sizing of text frame. . Can return: Boolean or NothingEnum enumerator. |
||
read/write |
If true, line-breaks are not introduced after auto sizing. . Can return: Boolean or NothingEnum enumerator. |
||
readonly |
If true, the text wrap path has been explicitly modified by the user. Can return: Boolean or NothingEnum enumerator. |
||
read/write |
The vertical alignment of the text content. . Can return: VerticalJustification enumerator or NothingEnum enumerator. |
||
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) |
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. |
Method Listing
String actualText ()
Provides the actual text for the object
EventListener addEventListener (eventType:String, handler:Varies File JavaScriptFunction, [captures:Boolean=Boolean])
Adds an event listener.
Parameter |
Type |
Description |
---|---|---|
eventType |
The event type. |
|
handler |
JavaScriptFunction |
The event handler. Can accept: File or JavaScript Function. |
captures |
This parameter is obsolete. (Optional) (default: false) |
String altText ()
Provides the alternate text for the object
ChangeObjectPreference getElements ()
Resolves the object specifier, creating an array of object references.
Boolean removeEventListener (eventType:String, handler:Varies File JavaScriptFunction, [captures:Boolean=Boolean])
Removes the event listener.
Parameter |
Type |
Description |
---|---|---|
eventType |
The registered event type. |
|
handler |
JavaScriptFunction |
The registered event handler. Can accept: File or JavaScript Function. |
captures |
This parameter is obsolete. (Optional) (default: false) |
String toSource ()
Generates a string which, if executed, will return the ChangeObjectPreference.
String toSpecifier ()
Retrieves the object specifier.
Object of
Application.changeObjectPreferences
Event.parent
EventListener.parent
FindChangeContentTransparencySetting.parent
FindChangeFillTransparencySetting.parent
FindChangeStrokeTransparencySetting.parent
FindChangeTransparencySetting.parent
MutationEvent.parent
Preference.parent