Class: Polygon | K4 InDesign Javascript API Documentation

A polygon. Any shape that is not a rectangle, ellipse, or graphic line. When you add a polygon, InDesign creates a regular polygon based on the current polygon preferences settings.

Extends

SplineItem

Static Properties

Name	Description
AFTER_PLACE = "afterPlace"	string Dispatched after a Polygon is placed. This event bubbles. This event is not cancelable.
BEFORE_PLACE = "beforePlace"	string Dispatched before a Polygon is placed. This event bubbles. This event is cancelable.

Instance Properties

Name	Description	Access
absoluteFlip	Flip Indicates whether the Polygon has been flipped independently of its parent object and, if yes, the direction in which the Polygon was flipped.	read-write
absoluteHorizontalScale	number The horizontal scale of the Polygon relative to its containing object.	read-write
absoluteRotationAngle	number The rotation angle of the Polygon relative to its containing object. (Range: -360 to 360)	read-write
absoluteShearAngle	number The skewing angle of the Polygon relative to its containing object. (Range: -360 to 360)	read-write
absoluteVerticalScale	number The vertical scale of the Polygon relative to its containing object.	read-write
allArticles	Article The list of all articles this page item is part of	read-only
allGraphics	Graphic Lists all graphics contained by the Polygon.	read-only
allPageItems	PageItem Lists all page items contained by the Polygon.	read-only
allowOverrides	bool If true, the master page item can be overridden.	read-write
anchoredObjectSettings	AnchoredObjectSetting Anchored object settings.	read-only
animationSettings	AnimationSetting The page item animation settings.	read-only
appliedObjectStyle	ObjectStyle The object style applied to the Polygon.	read-write
arrowHeadAlignment	ArrowHeadAlignmentEnum The arrowhead alignment applied to the Polygon.	read-write
associatedXMLElement	XMLItem The XML element associated with the Polygon.	read-only
bottomLeftCornerOption	CornerOptions The shape to apply to the bottom left corner of rectangular shapes.	read-write
bottomLeftCornerRadius	Measurement Unit (Number or String)=any The radius in measurement units of the corner effect applied to the bottom left corner of rectangular shapes	read-write
bottomRightCornerOption	CornerOptions The shape to apply to the bottom right corner of rectangular shapes.	read-write
bottomRightCornerRadius	Measurement Unit (Number or String)=any The radius in measurement units of the corner effect applied to the bottom right corner of rectangular shapes	read-write
buttons	Buttons A collection of buttons.	read-only
checkBoxes	CheckBoxes A collection of checkboxes.	read-only
comboBoxes	ComboBoxes A collection of comboboxes.	read-only
contentTransparencySettings	ContentTransparencySetting Transparency settings for the content of the Polygon.	read-only
contentType	ContentType The type of content that a frame can contain.	read-write
endCap	EndCap The end shape of an open path.	read-write
endJoin	EndJoin The corner join applied to the Polygon.	read-write
endnoteTextFrames	EndnoteTextFrames A collection of endnote text frames.	read-only
epss	EPSs A collection of EPS files.	read-only
epstexts	EPSTexts EPSTexts	read-only
eventListeners	EventListeners A collection of event listeners.	read-only
events	Events A collection of events.	read-only
fillColor	Swatch The swatch (color, gradient, tint, or mixed ink) applied to the fill of the Polygon. . Can also accept: String.	read-write
fillTint	number The percent of tint to use in the Polygon'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.)	read-write
fillTransparencySettings	FillTransparencySetting Transparency settings for the fill applied to the Polygon.	read-only
flip	Flip The direction in which to flip the printed image.	read-write
formFields	FormFields A collection of form fields.	read-only
frameFittingOptions	FrameFittingOption The frame fitting option to apply to placed or pasted content. Can be applied to a frame, object style, or document or to the application.	read-only
gapColor	Swatch The swatch (color, gradient, tint, or mixed ink) applied to the gap of a dashed, dotted, or striped stroke. For information, see stroke type.	read-write
gapTint	number 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.)	read-write
geometricBounds	Measurement Unit (Number or String)=any The bounds of the Polygon excluding the stroke width, in the format [y1, x1, y2, x2], which give the coordinates of the top-left and bottom-right corners of the bounding box.	read-write
gradientFillAngle	number The angle of a linear gradient applied to the fill of the Polygon. (Range: -180 to 180)	read-write
gradientFillLength	Measurement Unit (Number or String)=any The length (for a linear gradient) or radius (for a radial gradient) applied to the fill of the Polygon.	read-write
gradientFillStart	Measurement Unit (Number or String)=any The starting point (in page coordinates) of a gradient applied to the fill of the Polygon, in the format [x, y].	read-write
gradientStrokeAngle	number The angle of a linear gradient applied to the stroke of the Polygon. (Range: -180 to 180)	read-write
gradientStrokeLength	Measurement Unit (Number or String)=any The length (for a linear gradient) or radius (for a radial gradient) applied to the stroke of the Polygon.	read-write
gradientStrokeStart	Measurement Unit (Number or String)=any The starting point (in page coordinates) of a gradient applied to the stroke of the Polygon, in the format [x, y].	read-write
graphicLines	GraphicLines A collection of graphic lines.	read-only
graphics	Graphics A collection of imported graphics in any graphic file format (vector, metafile, or bitmap).	read-only
groups	Groups A collection of groups.	read-only
horizontalLayoutConstraints	DimensionsConstraints The left margin, width, and right margin constraints this item is subject to when using the object-based layout rule.	read-write
horizontalScale	number The horizontal scaling applied to the Polygon.	read-write
htmlItems	HtmlItems A collection of embedded HTML page items.	read-only
id	number The unique ID of the Polygon.	read-only
images	Images A collection of bitmap images in any bitmap file format (including TIFF, JPEG, or GIF).	read-only
importedPages	ImportedPages Imported InDesign pages.	read-only
incopyExportOptions	InCopyExportOption Export options for InCopy INCX document format.	read-only
index	number The index of the Polygon within its containing object.	read-only
isValid	bool Returns true if the object specifier resolves to valid objects.	read-only
itemLayer	Layer The layer that the Polygon is on.	read-write
k4FileVersionIndex	number K4 File Version Index	read-only
k4Id	string K4 Server ID	read-only
k4Name	string K4 Name	read-only
k4ObjectLabel	string K4 Object Label	read-only
k4ObjectState	K4ObjectState K4 Object State	read-only
k4ObjectType	K4ObjectType K4 Object Type	read-only
k4OutputChannelName	string K4 Output Channel Name	read-only
k4Position	number K4 position	read-only
k4PublicationId	string K4 Publication ID	read-only
k4VariantId	string K4 Variant ID	read-only
k4WfChannelId	string K4 Workflow Channel ID	read-only
k4WfDefinitionId	string K4 Workflow Definition ID	read-only
k4WfName	string K4 Workflow Name	read-only
k4WfObjectType	K4WfObjectType K4 Workflow Object Type	read-only
k4WfObjectVariantId	string K4 Workflow Object Variant ID	read-only
label	string A property that can be set to any string.	read-write
leftArrowHeadScale	number The scaling applied to the arrowhead at the start of the path. (Range: 1 to 1000)	read-write
leftLineEnd	ArrowHead The arrowhead applied to the start of the path.	read-write
linkedPageItemOptions	LinkedPageItemOption Linked Page Item options	read-only
listBoxes	ListBoxes A collection of listboxes.	read-only
localDisplaySetting	DisplaySettingOptions Display performance options for the Polygon.	read-write
locked	bool If true, the Polygon is locked.	read-write
mediaItems	MediaItems The media items collection.	read-only
miterLimit = 4	number The limit of the ratio of stroke width to miter length before a miter (pointed) join becomes a bevel (squared-off) join.	read-write
movies	Movies A collection of movies.	read-only
multiStateObjects	MultiStateObjects A collection of multi-state objects.	read-only
name	string The name of the Polygon.	read-write
nonprinting	bool If true, the Polygon does not print.	read-write
objectExportOptions	ObjectExportOption Export options for the object	read-only
ovals	Ovals A collection of ellipses.	read-only
overprintFill	bool If true, the Polygon's fill color overprints any underlying objects. If false, the fill color knocks out the underlying colors.	read-write
overprintGap	bool If true, the gap color overprints any underlying colors. If false, the gap color knocks out the underlying colors.	read-write
overprintStroke	bool If true, the Polygon's stroke color overprints any underlying objects. If false, the stroke color knocks out the underlying colors.	read-write
overridden	bool If 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.	read-only
overriddenMasterPageItem	An object that originated on a master page and has been overridden. Can return: PageItem, Guide, Graphic, Movie or Sound.	read-only
pageItems	PageItems The page items collection, which can be used to process all page items in a container (such as a document, page, or group), regardless of type.	read-only
parent	The parent of the Polygon (a ComboBox, ListBox, TextBox, SignatureField, Spread, MasterSpread, SplineItem, Polygon, GraphicLine, Rectangle, Oval, Group, State, Cell, Character, PlaceGun or Snippet).	read-only
parentPage	Page The page on which this page item appears.	read-only
paths	Paths A collection of paths.	read-only
pdfs	PDFs A collection of PDF files.	read-only
picts	PICTs A collection of PICT graphics.	read-only
polygons	Polygons A collection of polygons.	read-only
preferences	Preferences A collection of preferences objects.	read-only
properties	Object A property that allows setting of several properties at the same time.	read-write
radioButtons	RadioButtons A collection of radio buttons.	read-only
rectangles	Rectangles A collection of rectangles.	read-only
rightArrowHeadScale	number The scaling applied to the arrowhead at the end of the path. (Range: 1 to 1000)	read-write
rightLineEnd	ArrowHead The arrowhead applied to the end of the path.	read-write
rotationAngle	number The rotatation angle of the Polygon. (Range: -360 to 360)	read-write
shearAngle	number The skewing angle applied to the Polygon. (Range: -360 to 360)	read-write
signatureFields	SignatureFields A collection of signature fields.	read-only
sounds	Sounds A collection of sound clips.	read-only
splineItems	SplineItems The spline items collection.	read-only
storyTitle	string Title for this InCopy story.	read-write
strokeAlignment	StrokeAlignment The stroke alignment applied to the Polygon.	read-write
strokeColor	Swatch The swatch (color, gradient, tint, or mixed ink) applied to the stroke of the Polygon. Can also accept: String.	read-write
strokeCornerAdjustment	StrokeCornerAdjustment The corner adjustment applied to the Polygon.	read-write
strokeDashAndGap	Measurement Unit (Number or String)=any 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].	read-write
strokeTint	number 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.)	read-write
strokeTransparencySettings	StrokeTransparencySetting Transparency settings for the stroke.	read-only
strokeType	StrokeStyle The name of the stroke style to apply. Can also accept: String.	read-write
strokeWeight	Measurement Unit (Number or String)=any The weight (in points) to apply to the Polygon's stroke.	read-write
textBoxes	TextBoxes A collection of text boxes.	read-only
textFrames	TextFrames A collection of text frames.	read-only
textPaths	TextPaths A collection of text paths.	read-only
textWrapPreferences	TextWrapPreference The text wrap preference properties that define the default formatting for wrapping text around objects.	read-only
timingSettings	TimingSetting The object timing settings.	read-only
topLeftCornerOption	CornerOptions 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.	read-write
topLeftCornerRadius	Measurement Unit (Number or String)=any 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	read-write
topRightCornerOption	CornerOptions The shape to apply to the top right corner of rectangular shapes	read-write
topRightCornerRadius	Measurement Unit (Number or String)=any The radius in measurement units of the corner effect applied to the top right corner of rectangular shapes	read-write
transparencySettings	TransparencySetting Transparency settings.	read-only
verticalLayoutConstraints	DimensionsConstraints The top margin, height, and bottom margin constraints this item is subject to when using the object-based layout rule.	read-write
verticalScale	number The vertical scaling applied to the Polygon.	read-write
visible	bool If true, the Polygon is visible.	read-write
visibleBounds	Measurement Unit (Number or String)=any The bounds of the Polygon including the stroke width, in the format [y1, x1, y2, x2], which give the coordinates of the top-left and bottom-right corners of the bounding box.	read-write
wmfs	WMFs A collection of WMF graphics.	read-only

Methods

addEventListener(

eventType, handler [, captures])

→ EventListener

addPath(

with)

→ PageItem

applyObjectStyle(

using [, clearingOverrides] [, clearingOverridesThroughRootObjectStyle])

asynchronousExportFile(

format, to [, showingOptions] [, using] [, versionComments] [, forceSave])

→ BackgroundTask

)

)

[reference])

[reverseOrder])

→ PageItem

clearFrameFittingOptions(

)

clearObjectStyleOverrides(

)

clearTransformations(

)

contentPlace(

pageItems [, linkPageItems] [, linkStories] [, mapStyles] [, showingOptions])

convertShape(

given [, numberOfSides] [, insetPercentage] [, cornerRadius])

createEmailQRCode(

[emailAddress] [, subject] [, body], qrCodeSwatch [, withProperties])

createHyperlinkQRCode(

[urlLink], qrCodeSwatch [, withProperties])

createPlainTextQRCode(

[plainText], qrCodeSwatch [, withProperties])

createTextMsgQRCode(

[cellNumber] [, textMessage], qrCodeSwatch [, withProperties])

createVCardQRCode(

[firstName] [, lastName] [, jobTitle] [, cellPhone] [, phone] [, email] [, organisation] [, streetAddress] [, city] [, adrState] [, country] [, postalCode] [, website], qrCodeSwatch [, withProperties])

detach(

)

duplicate(

to [, by])

→ PageItem

excludeOverlapPath(

with)

→ PageItem

exportFile(

format, to [, showingOptions] [, using] [, versionComments] [, forceSave])

extractLabel(

key)

→ string

findObject(

[reverseOrder])

→ PageItem

fit(

given)

flipItem(

given, around)

getElements(

)

→ Polygon

insertLabel(

key, value)

intersectPath(

with)

→ PageItem

k4GetArticle(

)

→ K4Article

k4GetDocument(

)

→ Document

k4GetServerData(

)

→ K4ServerData

k4Place(

k4PublicationId, k4WFObjectVariantId)

k4SwitchVariant(

k4Id)

k4Update(

)

makeCompoundPath(

with)

→ PageItem

markup(

using)

minusBack(

with)

→ PageItem

move(

to [, by])

override(

destinationPage)

place(

fileName [, showingOptions] [, withProperties])

using)

[to])

in, opposingCorners)

)

→ PageItem

remove(

)

removeEventListener(

eventType, handler [, captures])

→ bool

removeOverride(

)

resize(

in, from, by, values [, resizeIndividually] [, consideringRulerUnits])

resolve(

location, in [, consideringRulerUnits])

[existingSelection])

)

[reference])

using [, withProperties])

→ Asset

subtractPath(

with)

→ PageItem

toSource(

)

→ string

toSpecifier(

)

→ string

transform(

in, from, withMatrix, replacingCurrent [, consideringRulerUnits])

transformAgain(

)

→ string

transformAgainIndividually(

)

→ string

transformSequenceAgain(

)

→ string

transformSequenceAgainIndividually(

)

→ string

transformValuesOf(

in)

→ TransformationMatrix

addEventListener( eventType, handler [, captures=false]) → EventListener

Adds an event listener.

`eventType`	string The event type.
`handler`	The event handler. Can accept: File or JavaScript Function.
`captures`	bool This parameter is obsolete. (Optional)

addPath( with) → PageItem

Creates a new page item by combining the Polygon with other objects. Deletes the objects if they do not intersect.

with Array<PageItem> The object(s) to add.

applyObjectStyle( using [, clearingOverrides=true] [, clearingOverridesThroughRootObjectStyle=false])

Applies the specified object style.

`using`	ObjectStyle The object style to apply.
`clearingOverrides`	bool If true, clears the Polygon's existing attributes before applying the style. (Optional)
`clearingOverridesThroughRootObjectStyle`	bool If true, clears attributes and formatting applied to the Polygon that are not defined in the object style. (Optional)

asynchronousExportFile( format, to [, showingOptions=false] [, using] [, versionComments] [, forceSave=false]) → BackgroundTask

asynchronously exports the object(s) to a file.

`format`	The export format, specified as an enumeration value or as an extension that appears in the Save as type or Format menu in the Export dialog. Can accept: ExportFormat enumerator or String.
`to`	File The path to the export file.
`showingOptions`	bool If true, displays the export options dialog. (Optional)
`using`	PDFExportPreset The export style. (Optional)
`versionComments`	string The comment for this version. (Optional)
`forceSave`	bool If true, forcibly saves a version. (Optional)

autoTag( )

Tag the object or the parent story using default tags defined in XML preference.

bringForward( )

Brings the Polygon forward one level in its layer.

bringToFront( [reference])

Brings the Polygon to the front of its layer or in front of a particular item.

reference PageItem The reference object to bring the object in front of (must have same parent) (Optional)

changeObject( [reverseOrder]) → PageItem

Finds objects that match the find what value and replace the objects with the change to value.

reverseOrder bool If true, returns the results in reverse order. (Optional)

clearFrameFittingOptions( )

Removes the frame fittings options and resets it to the initial state.

clearObjectStyleOverrides( )

Clear overrides for object style

clearTransformations( )

Clears transformations from the Polygon. Transformations include rotation, scaling, flipping, fitting, and shearing.

contentPlace( pageItems [, linkPageItems=false] [, linkStories=false] [, mapStyles=false] [, showingOptions=false])

Duplicate an object and place it into the target page item.

`pageItems`	Array<PageItem> One or more page items to place or load
`linkPageItems`	bool Whether to link pageItems in content placer (if true it will override link stories value) (Optional)
`linkStories`	bool Whether to link stories in content placer (only applicable for single story, pageItem links will also be created in case of more than one item) (Optional)
`mapStyles`	bool Whether to map styles in content placer (Optional)
`showingOptions`	bool Whether to display the link options dialog (Optional)

convertShape( given [, numberOfSides] [, insetPercentage] [, cornerRadius])

Converts the Polygon to a different shape.

`given`	ConvertShapeOptions The Polygon's new shape.
`numberOfSides`	number The number of sides for the resulting polygon. (Range: 3 to 100) (Optional)
`insetPercentage`	number The star inset percentage for the resulting polygon. (Range: 0.0 to 100.0) (Optional)
`cornerRadius`	Measurement Unit (Number or String)=any The corner radius of the resulting rectangle. (Optional)

createEmailQRCode( [emailAddress] [, subject] [, body], qrCodeSwatch [, withProperties])

Create Email QR Code on the page item or document

`emailAddress`	string QR code Email Address (Optional)
`subject`	string QR code Email Subject (Optional)
`body`	string QR code Email Body Message (Optional)
`qrCodeSwatch`	Swatch to be applied on generated QR Code Graphic . Can accept: Swatch or String. (Optional)
`withProperties`	Array<string> Initial values for properties of the new Polygon. Above parameters can also be passed as properties (Optional)

createHyperlinkQRCode( [urlLink], qrCodeSwatch [, withProperties])

Create Hyperlink QR Code on the page item or document

`urlLink`	string QR code Hyperlink URL (Optional)
`qrCodeSwatch`	Swatch to be applied on generated QR Code Graphic . Can accept: Swatch or String. (Optional)
`withProperties`	Array<string> Initial values for properties of the new Polygon. Above parameters can also be passed as properties (Optional)

createPlainTextQRCode( [plainText], qrCodeSwatch [, withProperties])

Create Plain Text QR Code on the page item

`plainText`	string QR code Plain Text (Optional)
`qrCodeSwatch`	Swatch to be applied on generated QR Code Graphic . Can accept: Swatch or String. (Optional)
`withProperties`	Array<string> Initial values for properties of the new Polygon. Above parameters can also be passed as properties (Optional)

createTextMsgQRCode( [cellNumber] [, textMessage], qrCodeSwatch [, withProperties])

Create Text Msg QR Code on the page item or document

`cellNumber`	string QR code Text Phone Number (Optional)
`textMessage`	string QR code Text Message (Optional)
`qrCodeSwatch`	Swatch to be applied on generated QR Code Graphic . Can accept: Swatch or String. (Optional)
`withProperties`	Array<string> Initial values for properties of the new Polygon. Above parameters can also be passed as properties (Optional)

createVCardQRCode( [firstName] [, lastName] [, jobTitle] [, cellPhone] [, phone] [, email] [, organisation] [, streetAddress] [, city] [, adrState] [, country] [, postalCode] [, website], qrCodeSwatch [, withProperties])

Create Business Card QR Code on the page item or load on document's placegun

`firstName`	string QR code Business Card First Name (Optional)
`lastName`	string QR code Business Card Last Name (Optional)
`jobTitle`	string QR code Business Card Title (Optional)
`cellPhone`	string QR code Business Card Cell Phone Number (Optional)
`phone`	string QR code Business Card Phone Number (Optional)
`email`	string QR code Business Card Email Address (Optional)
`organisation`	string QR code Business Card Organisation (Optional)
`streetAddress`	string QR code Business Card Street Address (Optional)
`city`	string QR code Business Card City (Optional)
`adrState`	string QR code Business Card State (Optional)
`country`	string QR code Business Card Country (Optional)
`postalCode`	string QR code Business Card Postal Code (Optional)
`website`	string QR code Business Card URL (Optional)
`qrCodeSwatch`	Swatch to be applied on generated QR Code Graphic . Can accept: Swatch or String. (Optional)
`withProperties`	Array<string> Initial values for properties of the new Polygon. Above parameters can also be passed as properties (Optional)

detach( )

Detaches an overridden master page item from the master page.

duplicate( to [, by]) → PageItem

Duplicates the Polygon at the specified location or offset.

`to`	The location of the new Polygon, specified in coordinates in the format [x, y]. Can accept: Array of 2 Units, Spread, Page or Layer. (Optional)
`by`	Array<Measurement Unit (Number or String)=any> Amount by which to offset the new Polygon from the original Polygon's position. (Optional)

excludeOverlapPath( with) → PageItem

Creates a new page item by excluding the overlapping areas of the Polygon and other objects.

with Array<PageItem> The object(s) to exclude.

exportFile( format, to [, showingOptions=false] [, using] [, versionComments] [, forceSave=false])

Exports the object(s) to a file.

`format`	The export format, specified as an enumeration value or as an extension that appears in the Save as type or Format menu in the Export dialog. Can accept: ExportFormat enumerator or String.
`to`	File The path to the export file.
`showingOptions`	bool If true, displays the export options dialog. (Optional)
`using`	PDFExportPreset The export style. (Optional)
`versionComments`	string The comment for this version. (Optional)
`forceSave`	bool If true, forcibly saves a version. (Optional)

extractLabel( key) → string

Gets the label value associated with the specified key.

key string The key.

findObject( [reverseOrder]) → PageItem

Finds objects that match the find what value.

reverseOrder bool If true, returns the results in reverse order. (Optional)

fit( given)

Applies the specified fit option to content in a frame.

given FitOptions The fit option to use.

flipItem( given, around)

Flips the Polygon.

`given`	Flip The axis around which to flip the Polygon.
`around`	The point around which to flip the Polygon. Can accept: Array of 2 Units or AnchorPoint enumerator. (Optional)

getElements( ) → Polygon

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

insertLabel( key, value)

Sets the label to the value associated with the specified key.

`key`	string The key.
`value`	string The value.

intersectPath( with) → PageItem

Creates a new page item by intersecting the Polygon with other objects. Returns an error if the objects do not intersect.

with Array<PageItem> The object(s) with which to intersect.

k4GetArticle( ) → K4Article

K4 Get Article

k4GetDocument( ) → Document

K4 Get Document

k4GetServerData( ) → K4ServerData

K4 Get Server Data

k4Place( k4PublicationId, k4WFObjectVariantId)

K4 Place Object into

`k4PublicationId`	string K4 Publication DB ID
`k4WFObjectVariantId`	string K4 Workflow Object Variant DB ID

k4SwitchVariant( k4Id)

K4 Switch Variant

k4Id string K4 ID

k4Update( )

K4 Update

makeCompoundPath( with) → PageItem

Creates a compound path by combining the path(s) of the Polygon with the paths of other objects.

with Array<PageItem> The other objects whose paths to include in the new compound path.

markup( using)

Associates the page item with the specified XML element while preserving existing content.

using XMLElement The XML element.

minusBack( with) → PageItem

Creates a new page item by reverse subtracting the overlapping areas of the Polygon and other objects.

with Array<PageItem> The object(s) to reverse subtract.

move( to [, by])

Moves the Polygon to a new location. Note: Either the 'to' or 'by' parameter is required; if both parameters are defined, only the to value is used.

`to`	The new location of the Polygon,in the format (x, y). Can accept: Array of 2 Units, Spread, Page or Layer. (Optional)
`by`	Array<Measurement Unit (Number or String)=any> The amount (in measurement units) to move the Polygon relative to its current position, in the format (x, y). (Optional)

override( destinationPage)

Overrides a master page item and places the item on the document page as a new object.

destinationPage Page The document page that contains the master page item to override.

place( fileName [, showingOptions=false] [, withProperties])

Places the file.

`fileName`	File The file to place
`showingOptions`	bool Whether to display the import options dialog (Optional)
`withProperties`	Object Initial values for properties of the placed object(s) (Optional)

placeXML( using)

Places XML content into the specified object. Note: Replaces any existing content.

using XMLElement The XML element whose content you want to place.

redefineScaling( [to])

Apply an item's scaling to its content if possible.

`to`	Array<number> The scale factors to be left on the item. The default is {1.0, 1.0}. (Optional)

reframe( in, opposingCorners)

Move the bounding box of the page item

`in`	The bounding box to resize. Can accept: CoordinateSpaces enumerator or Ordered array containing coordinateSpace:CoordinateSpaces enumerator, boundsKind:BoundingBoxLimits enumerator.
`opposingCorners`	Opposing corners of new bounding box in the given coordinate space

releaseCompoundPath( ) → PageItem

Releases a compound path.

remove( )

Deletes the Polygon.

removeEventListener( eventType, handler [, captures=false]) → bool

Removes the event listener.

`eventType`	string The registered event type.
`handler`	The registered event handler. Can accept: File or JavaScript Function.
`captures`	bool This parameter is obsolete. (Optional)

removeOverride( )

Removes the override from a previously overridden master page item.

resize( in, from, by, values [, resizeIndividually=true] [, consideringRulerUnits=false])

Resize the page item.

`in`	The bounding box to resize. Can accept: CoordinateSpaces enumerator, BoundingBoxLimits enumerator or Ordered array containing coordinateSpace:CoordinateSpaces enumerator, boundsKind:BoundingBoxLimits enumerator.
`from`	The transform origin. Legal specifications: relative to bounding box: anchor \| {anchor \| {x,y}, bounds kind [, coordinate space]}; relative to coordinate space: {x,y} \| {{x,y}[, coordinate space]}; relative to layout window ruler: {{x,y}, page index \| bounds kind}. Can accept: Array of 2 Reals, AnchorPoint enumerator or Array of Arrays of 2 Reals, CoordinateSpaces enumerators, AnchorPoint enumerators, BoundingBoxLimits enumerators or Long Integers.
`by`	ResizeMethods How the current dimensions are affected by the given values
`values`	The width and height values. Legal dimensions specifications: {x, y [, coordinate space]}, {x, resize constraint [, coordinate space]}, or {resize constraint, y [, coordinate space]}; where x and y are real numbers and coordinate space is used to determine _only_ the unit of length for x and y; coordinate space is ignored for the 'current dimensions times' resize method). Can accept: Array of Reals, ResizeConstraints enumerators or CoordinateSpaces enumerators.
`resizeIndividually`	bool If false and multiple page items are targeted, the new dimensions are attained only by moving the individual items rather than resizing them. (Optional)
`consideringRulerUnits`	bool If true then a ruler location is interpreted using ruler units rather than points. The default value is false. This parameter has no effect unless the reference point is specified relative to a page. (Optional)

resolve( location, in [, consideringRulerUnits=false])

Get the coordinates of the given location in the specified coordinate system.

`location`	The location requested. Can accept: Array of 2 Reals, AnchorPoint enumerator or Array of Arrays of 2 Reals, CoordinateSpaces enumerators, AnchorPoint enumerators, BoundingBoxLimits enumerators or Long Integers.
`in`	CoordinateSpaces The coordinate space to use.
`consideringRulerUnits`	bool If true then a ruler location is interpreted using ruler units rather than points. The default value is false. This parameter has no effect unless the reference point is specified relative to a page. (Optional)

select( [existingSelection=SelectionOptions.REPLACE_WITH])

Selects the object.

existingSelection SelectionOptions The selection status of the Polygon in relation to previously selected objects. (Optional)

sendBackward( )

Sends the Polygon back one level in its layer.

sendToBack( [reference])

Sends the Polygon to the back of its layer or behind a particular item (must have same parent).

reference PageItem The reference object to send the object behind (Optional)

store( using [, withProperties]) → Asset

Stores the object in the specified library.

`using`	Library The library in which to store the object.
`withProperties`	Object Initial values for properties of the new Polygon (Optional)

subtractPath( with) → PageItem

Creates a new page item by subtracting the overlapping areas of the Polygon and other objects.

with Array<PageItem> The object(s) to subtract.

toSource( ) → string

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

toSpecifier( ) → string

Retrieves the object specifier.

transform( in, from, withMatrix, replacingCurrent [, consideringRulerUnits=false])

Transform the page item.

`in`	CoordinateSpaces The coordinate space to use
`from`	The temporary origin during the transformation. Can accept: Array of 2 Reals, AnchorPoint enumerator or Array of Arrays of 2 Reals, CoordinateSpaces enumerators, AnchorPoint enumerators, BoundingBoxLimits enumerators or Long Integers.
`withMatrix`	Transform matrix. Can accept: Array of 6 Reals or TransformationMatrix.
`replacingCurrent`	Transform components to consider; providing this optional parameter causes the target's existing transform components to be replaced with new values. Without this parameter, the given matrix is concatenated onto the target's existing transform combining the effect of the two. Can accept: MatrixContent enumerator, Array of MatrixContent enumerators or Long Integer. (Optional)
`consideringRulerUnits`	bool If true then a ruler based origin is interpreted using ruler units rather than points. The default value is false. This parameter has no effect unless the reference point is specified relative to a page. (Optional)

transformAgain( ) → string

Transforms the Polygon using the last transformation performed on any object. Transformations include moving, rotating, shearing, scaling, and flipping.

transformAgainIndividually( ) → string

Transforms the Polygon using the last transformation performed on any Polygon. Transformations include moving, rotating, shearing, scaling, and flipping.

transformSequenceAgain( ) → string

Transforms the Polygon using the last sequence of transform operations performed on any single object or performed at the same time on any group of objects. Transformations include moving, rotating, shearing, scaling, and flipping.

transformSequenceAgainIndividually( ) → string

Transforms the Polygon using the last sequence of transformations performed on any single object or performed at the same time on any group of objects. Transformations include moving, rotating, shearing, scaling, and flipping.

transformValuesOf( in) → TransformationMatrix

Get the transformation values of the page item.

`in`	CoordinateSpaces The coordinate space to use