GraphItem
GraphItem
Section titled “GraphItem”app.activeDocument.graphItems[index]
Description
Section titled “Description”Any graph artwork object. See example Rotating graph items.
Properties
Section titled “Properties”GraphItem.artworkKnockout
Section titled “GraphItem.artworkKnockout”app.activeDocument.graphItems[index].artworkKnockout
Description
Section titled “Description”Is this object used to create a knockout, and if so, what kind of knockout. You cannot set this value to KnockoutState.Unknown.
GraphItem.blendingMode
Section titled “GraphItem.blendingMode”app.activeDocument.graphItems[index].blendingMode
Description
Section titled “Description”The mode used when compositing an object.
GraphItem.contentVariable
Section titled “GraphItem.contentVariable”app.activeDocument.graphItems[index].contentVariable
Description
Section titled “Description”The content variable bound to the graph item.
It is not necessary to set the type of the contentVariable before binding. Illustrator automatically set the type to GRAPH.
GraphItem.controlBounds
Section titled “GraphItem.controlBounds”app.activeDocument.graphItems[index].controlBounds
Description
Section titled “Description”The content variable bound to the graph item.
The bounds of the object including stroke width and controls.
Array of 4 numbers; read-only.
GraphItem.editable
Section titled “GraphItem.editable”app.activeDocument.graphItems[index].editable
Description
Section titled “Description”If true, this graph item is editable.
Boolean; read-only.
GraphItem.geometricBounds
Section titled “GraphItem.geometricBounds”app.activeDocument.graphItems[index].geometricBounds
Description
Section titled “Description”The bounds of the object excluding stroke width.
Array of 4 numbers; read-only.
GraphItem.height
Section titled “GraphItem.height”app.activeDocument.graphItems[index].height
Description
Section titled “Description”The height of the graph item.
Number (double); read-only.
GraphItem.hidden
Section titled “GraphItem.hidden”app.activeDocument.graphItems[index].hidden
Description
Section titled “Description”If true, this graph item is hidden.
Boolean.
GraphItem.isIsolated
Section titled “GraphItem.isIsolated”app.activeDocument.graphItems[index].isIsolated
Description
Section titled “Description”If true, this object is isolated.
Boolean.
GraphItem.layer
Section titled “GraphItem.layer”app.activeDocument.graphItems[index].layer
Description
Section titled “Description”The layer to which this graph item belongs.
Layer; read-only.
GraphItem.left
Section titled “GraphItem.left”app.activeDocument.graphItems[index].left
Description
Section titled “Description”The offset (in points) of the left side of the graph item from the left side of the page.
Number.
GraphItem.locked
Section titled “GraphItem.locked”app.activeDocument.graphItems[index].locked
Description
Section titled “Description”If true, this graph item is locked.
Boolean.
GraphItem.name
Section titled “GraphItem.name”app.activeDocument.graphItems[index].name
Description
Section titled “Description”The name of this graph item.
String.
GraphItem.note
Section titled “GraphItem.note”app.activeDocument.graphItems[index].note
Description
Section titled “Description”The note assigned to this item.
String.
GraphItem.opacity
Section titled “GraphItem.opacity”app.activeDocument.graphItems[index].opacity
Description
Section titled “Description”The opacity of the object; the value is between 0.0 and 100.0.
Number (double)
GraphItem.parent
Section titled “GraphItem.parent”app.activeDocument.graphItems[index].parent
Description
Section titled “Description”The parent of this object.
GraphItem.position
Section titled “GraphItem.position”app.activeDocument.graphItems[index].position
Description
Section titled “Description”The position (in points) of the top left corner of the graphItem object in the format [x, y]. Does not include stroke weight.
Array of 2 numbers.
GraphItem.selected
Section titled “GraphItem.selected”app.activeDocument.graphItems[index].selected
Description
Section titled “Description”If true, this object is selected.
Boolean.
GraphItem.sliced
Section titled “GraphItem.sliced”app.activeDocument.graphItems[index].sliced
Description
Section titled “Description”If true, the graph item is sliced.
Default: false.
Boolean.
GraphItem.tags
Section titled “GraphItem.tags”app.activeDocument.graphItems[index].tags
Description
Section titled “Description”The tags contained in this graph item.
Tags; read-only.
GraphItem.top
Section titled “GraphItem.top”app.activeDocument.graphItems[index].top
Description
Section titled “Description”The offset (in points) of the top of the graph item from the bottom of the page.
Number (double).
GraphItem.typename
Section titled “GraphItem.typename”app.activeDocument.graphItems[index].typename
Description
Section titled “Description”The type of the graph item.
String; read-only.
GraphItem.uRL
Section titled “GraphItem.uRL”app.activeDocument.graphItems[index].uRL
Description
Section titled “Description”The value of the Adobe URL tag assigned to this graph item.
String.
GraphItem.visibilityVariable
Section titled “GraphItem.visibilityVariable”app.activeDocument.graphItems[index].visibilityVariable
Description
Section titled “Description”The visibility variable bound to the graph item.
It is not necessary to set the type of the visibilityVariable before binding. Illustrator automatically set the type to VISIBILITY.
GraphItem.visibleBounds
Section titled “GraphItem.visibleBounds”app.activeDocument.graphItems[index].visibleBounds
Description
Section titled “Description”The visible bounds of the graph item including stroke width.
Array of 4 numbers; read-only.
GraphItem.width
Section titled “GraphItem.width”app.activeDocument.graphItems[index].width
Description
Section titled “Description”The width of the graph item.
Range: 0.0 to 16348.0.
Number (double).
GraphItem.wrapInside
Section titled “GraphItem.wrapInside”app.activeDocument.graphItems[index].wrapInside
Description
Section titled “Description”If true, the text frame object should be wrapped inside this object.
Boolean.
GraphItem.wrapOffset
Section titled “GraphItem.wrapOffset”app.activeDocument.graphItems[index].wrapOffset
Description
Section titled “Description”The offset to use when wrapping text around this object.
Number (double).
GraphItem.wrapped
Section titled “GraphItem.wrapped”app.activeDocument.graphItems[index].wrapped
Description
Section titled “Description”If true, wrap text frame objects around this object. (Text frame must be above the object.)
Boolean.
GraphItem.zOrderPosition
Section titled “GraphItem.zOrderPosition”app.activeDocument.graphItems[index].zOrderPosition
Description
Section titled “Description”The position of this art item within the stacking order of the group or layer (parent) that contains the art item.
Number (long).
Methods
Section titled “Methods”GraphItem.duplicate()
Section titled “GraphItem.duplicate()”app.activeDocument.graphItems[index].duplicate([relativeObject] [,insertionLocation])
Description
Section titled “Description”Creates a duplicate of the selected object.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
relativeObject | Object, optional | Object to duplicate to |
insertionLocation | ElementPlacement, optional | Location to insert element |
Returns
Section titled “Returns”GraphItem.move()
Section titled “GraphItem.move()”app.activeDocument.graphItems[index].move(relativeObject, insertionLocation)
Description
Section titled “Description”Moves the object.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
relativeObject | Object | Object to move element within |
insertionLocation | ElementPlacement, optional | Location to move element to |
Returns
Section titled “Returns”GraphItem.remove()
Section titled “GraphItem.remove()”app.activeDocument.graphItems[index].remove()
Description
Section titled “Description”Deletes this object.
Returns
Section titled “Returns”Nothing.
GraphItem.resize()
Section titled “GraphItem.resize()”app.activeDocument.graphItems[index].resize( scaleX, scaleY [,changePositions] [,changeFillPatterns] [,changeFillGradients] [,changeStrokePattern] [,changeLineWidths] [,scaleAbout])Description
Section titled “Description”Scales the art item where scaleX is the horizontal scaling factor and scaleY is the vertical scaling factor. 100.0 = 100%.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
scaleX | Number (double) | Horizontal scaling factor |
scaleY | Number (double) | Vertical scaling factor |
changePositions | Boolean, optional | Whether to effect art object positions and orientations |
changeFillPatterns | Boolean, optional | Whether to transform fill patterns |
changeFillGradients | Boolean, optional | Whether to transform fill gradients |
changeStrokePattern | Boolean, optional | Whether to transform stroke patterns |
changeLineWidths | Number (double), optional | The amount to scale line widths |
scaleAbout | Transformation, optional | The point to use as anchor, to transform about |
Returns
Section titled “Returns”Nothing.
GraphItem.rotate()
Section titled “GraphItem.rotate()”app.activeDocument.graphItems[index].rotate( angle [,changePositions] [,changeFillPatterns] [,changeFillGradients] [,changeStrokePattern] [,rotateAbout])Description
Section titled “Description”Rotates the art item relative to the current rotation. The object is rotated counter-clockwise if the angle value is positive, clockwise if the value is negative.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
angle | Number (double) | The angle amount to rotate the element |
changePositions | Boolean, optional | Whether to effect art object positions and orientations |
changeFillPatterns | Boolean, optional | Whether to transform fill patterns |
changeFillGradients | Boolean, optional | Whether to transform fill gradients |
changeStrokePattern | Boolean, optional | Whether to transform stroke patterns |
rotateAbout | Transformation, optional | The point to use as anchor, to transform about |
Returns
Section titled “Returns”Nothing.
GraphItem.transform()
Section titled “GraphItem.transform()”app.activeDocument.graphItems[index].transform( transformationMatrix [,changePositions] [,changeFillPatterns] [,changeFillGradients] [,changeStrokePattern] [,changeLineWidths] [,transformAbout])Description
Section titled “Description”Transforms the art item by applying a transformation matrix.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
transformationMatrix | Matrix | Transformation matrix to apply |
changePositions | Boolean, optional | Whether to change Positions |
changeFillPatterns | Boolean, optional | Whether to change Fill Patterns |
changeFillGradients | Boolean, optional | Whether to change Fill Gradients |
changeStrokePattern | Boolean, optional | Whether to change Stroke Pattern |
changeLineWidths | Number (double), optional | The amount to scale line widths |
transformAbout | Transformation, optional | The point to use as anchor, to transform about |
Returns
Section titled “Returns”Nothing.
GraphItem.translate()
Section titled “GraphItem.translate()”app.activeDocument.graphItems[index].translate( [deltaX] [,deltaY] [,transformObjects] [,transformFillPatterns] [,transformFillGradients] [,transformStrokePatterns])Description
Section titled “Description”Repositions the art item relative to the current position, where deltaX is the horizontal offset and deltaY is the vertical offset.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
deltaX | Number (double), optional | Horizontal offset |
deltaY | Number (double), optional | Vertical offset |
transformObjects | Boolean, optional | Whether to transform Objects |
transformFillPatterns | Boolean, optional | Whether to transform Fill Patterns |
transformFillGradients | Boolean, optional | Whether to transform Fill Gradients |
transformStrokePatterns | Boolean, optional | Whether to transform Stroke Patterns |
Returns
Section titled “Returns”Nothing.
GraphItem.zOrder()
Section titled “GraphItem.zOrder()”app.activeDocument.graphItems[index].zOrder(zOrderCmd)
Description
Section titled “Description”Arranges the art item’s position in the stacking order of the group or layer (parent) of this object.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
zOrderCmd | ZOrderMethod | Stacking order arrangement method |
Returns
Section titled “Returns”Nothing.