MACROMEDIA FIREWORKS MX 2004-EXTENDING FIREWORKS Manual page 112

Description
Adds a new image to the document containing the contents of the current paint-mode selection.
The new image is placed directly above the active bitmap. You must have a current pixel selection
for this to succeed. The new bitmap appears with Fireworks in paint mode.
dom.addNewImageViaCut()
Availability
Fireworks MX.
Usage
dom.addNewImageViaCut()
Arguments
None.
Returns
Nothing.
Description
Adds a new image to the document that contains the contents of the current paint mode
selection. The new image is placed directly above the active bitmap. You must have a current pixel
selection for this to succeed. The selection is cut from the previously active bitmap. The new
bitmap appears with Fireworks in paint mode.
dom.addNewLayer()
Availability
Fireworks 3.
Usage
dom.addNewLayer(name, bshared)
Arguments
A string that specifies the name for the new layer. If
name
is generated.
A Boolean value that specifies whether the new layer is shared.
bShared
Returns
A string value that contains the name of the new layer.
Description
Adds a new layer to the document and makes it the current layer.
Example
The following command adds a new unshared layer with a default name that is generated
by Fireworks.
fw.getDocumentDOM().addNewLayer(null, false);
112 Chapter 5: Fireworks JavaScript API
is , a new layer name
name null