Adobe InDesign CS4 (6.0) Object Model JS: Guide

InDesign CS4

Class

Guide

 A guide.

QuickLinks

detach, duplicate, extractLabel, getElements, insertLabel, move, override, remove, removeOverride, select, toSource, toSpecifier

Hierarchy

Page
Guide

Properties

PropertyTypeAccessDescription
allowOverridesbool r/wIf true, the master page item can be overridden.
fitToPagebool r/wIf true, horizontal orientation guides stop at the edges of the specified page. If false, the guides extends across the width of the spread and into the pasteboard area.
guideColor3 Reals (0 - 255)
UIColors
r/wThe color of the guide, 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.
idnumber readonlyThe unique ID of the Guide.
indexnumber readonlyThe index of the Guide within its containing object.
isValidbool readonlyReturns true if the object specifier resolves to valid objects.
itemLayerLayer r/wThe layer that the Guide is on.
labelstring r/wA property that can be set to any string.
locationMeasurement Unit (Number or String) r/wThe location at which to place the guide relative to the current ruler zero point.
lockedbool r/wIf true, the Guide is locked.
orientationHorizontalOrVertical:
HorizontalOrVertical.HORIZONTAL
HorizontalOrVertical.VERTICAL
r/wThe orientation of the guide.
overriddenbool readonlyIf true, the object originated on a master spread and was overridden. If false, the object either originated on a master spread and was not overridden, or the object did not originate on a master page.
overriddenMasterPageItemGraphic
Guide
Movie
PageItem
Sound
readonlyAn object that originated on a master page and has been overridden. Can return: PageItem, Guide, Graphic, Movie or Sound.
parentPage readonlyThe parent of the Guide (a Page).
propertiesObject r/wA property that allows setting of several properties at the same time.
viewThresholdnumber (range: 5 - 4000) r/wThe view magnification as a percentage below which guides are no longer displayed. (Range: 5.0 to 4000.0)

Methods

Instances

void detach ()
Detaches an overridden master page item from the master page.

Guide duplicate ()
Duplicates the Guide.

string extractLabel (key: string)
Gets the label value associated with the specified key.

ParameterTypeDescription
keystringThe key.

Array of Guide getElements ()
Resolves the object specifier, creating an array of object references.

void insertLabel (key: string, value: string)
Sets the label to the value associated with the specified key.

ParameterTypeDescription
keystringThe key.
valuestringThe value.

void move ([to: Array of Measurement Unit (Number or String)][, by: Array of Measurement Unit (Number or String)])
Moves the guide to a new location. Note: Either the to or the by parameter is required; if both parameters are defined, only the to value is used.

ParameterTypeDescription
toArray of Measurement Unit (Number or String)The new location of the guide, in the format [x, y]. (Optional)
byArray of Measurement Unit (Number or String)The amount to move the guide relative to its current position, in the format [x, y]. (Optional)

any override (destinationPage: Page)
Overrides a master page item and places the item on the document page as a new object.

ParameterTypeDescription
destinationPagePageThe document page that contains the master page item to override.

void remove ()
Deletes the Guide.

void removeOverride ()
Removes the override from a previously overridden master page item.

void select ([existingSelection: SelectionOptions=SelectionOptions.REPLACE_WITH])
Selects the object.

ParameterTypeDescription
existingSelectionSelectionOptions:
SelectionOptions.ADD_TO
SelectionOptions.REMOVE_FROM
SelectionOptions.REPLACE_WITH
The selection status of the Guide in relation to previously selected objects. (Optional) (default: SelectionOptions.REPLACE_WITH)

string toSource ()
Generates a string which, if executed, will return the Guide.

string toSpecifier ()
Retrieves the object specifier.

Element of

Button.overriddenMasterPageItem

EPS.overriddenMasterPageItem

FormField.overriddenMasterPageItem

Graphic.overriddenMasterPageItem

GraphicLine.overriddenMasterPageItem

Group.overriddenMasterPageItem

Guide.overriddenMasterPageItem

Image.overriddenMasterPageItem

ImportedPage.overriddenMasterPageItem

Movie.overriddenMasterPageItem

Oval.overriddenMasterPageItem

PDF.overriddenMasterPageItem

PICT.overriddenMasterPageItem

PageItem.overriddenMasterPageItem

Polygon.overriddenMasterPageItem

Rectangle.overriddenMasterPageItem

Sound.overriddenMasterPageItem

TextFrame.overriddenMasterPageItem

WMF.overriddenMasterPageItem

Used in:

array of Guide Guides.itemByRange (from: any, to: any)

Guide Guides.nextItem (obj: Guide)

Guide Guides.previousItem (obj: Guide)

Return

Guide Guide.duplicate ()

Array of Guide Guide.getElements ()

Guide Guides.[] (index: number)

Guide Guides.add ([layer: Layer][, withProperties: Object])

Guide Guides.anyItem ()

Array of Guide Guides.everyItem ()

Guide Guides.firstItem ()

Guide Guides.item (index: any)

Guide Guides.itemByID (id: number)

Guide Guides.itemByName (name: string)

Array of Guide Guides.itemByRange (from: any, to: any)

Guide Guides.lastItem ()

Guide Guides.middleItem ()

Guide Guides.nextItem (obj: Guide)

Guide Guides.previousItem (obj: Guide)

Jongware, 20-Jun-2010 v3.0.3dContents :: Index