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);
}