SymbolItems¶

app.activeDocument.symbolItems

Description¶

The collection of SymbolItem objects in the document.

Properties¶

SymbolItems.length¶

app.activeDocument.symbolItems.length

Description¶

Number of elements in the collection.

Type¶

Number; read-only.

SymbolItems.parent¶

app.activeDocument.symbolItems.parent

Description¶

The object's container.

Type¶

Object; read-only.

SymbolItems.typename¶

app.activeDocument.symbolItems.typename

Description¶

The class name of the object.

Type¶

String; read-only.

Methods¶

SymbolItems.add()¶

app.activeDocument.symbolItems.add(symbol)

Description¶

Creates an instance of the specified symbol.

Parameters¶

Parameter	Type	Description
`symbol`	Symbol	Symbol to instance

Returns¶

SymbolItem

SymbolItems.getByName()¶

app.activeDocument.symbolItems.getByName(name)

Description¶

Get the first element in the collection with the provided name.

Parameters¶

Parameter	Type	Description
`name`	String	Name of element to get

Returns¶

SymbolItem

SymbolItems.index()¶

app.activeDocument.symbolItems.index(itemKey)

Description¶

Gets an element from the collection.

Parameters¶

Parameter	Type	Description
`itemKey`	String, Number	String or number key

Returns¶

SymbolItem

SymbolItems.removeAll()¶

app.activeDocument.symbolItems.removeAll()

Description¶

Deletes all elements in the collection.

Returns¶

Nothing.

Example¶

Creating a symbol¶

// Creates a path item from each graphic style
// then adds each item as a new symbol

var docRef = documents.add();
var y = 750;
var x = 25;

var iCount = docRef.graphicStyles.length;

for (var i=0; i<iCount; i++) {

    var pathRef = docRef.pathItems.rectangle( y, x, 20, 20 );
    docRef.graphicStyles[i].applyTo(pathRef);

    // are we at bottom?
    if ( (y-=60) <= 60 ) {
        y = 750; // go back to the top.
        x+= 200
    }

    redraw();
    docRef.symbolItems.add(pathRef);
}