User Guide

Document functions 171
dom.moveSelectionToLayer()
Availability
Fireworks 3, enhanced in 4.
Usage
dom.moveSelectionToLayer(layerIndex, bMakeCopy, {whatIfMultipleSelected},
{elementIndex})
Arguments
layerIndex
An integer value that specifies the layer to which the selection should be moved or
copied, starting with 0 (although, to specify the current layer, pass –1 here).
bMakeCopy If bMakeCopy is true, the selection is copied instead of moved.
whatIfMultipleSelected An optional string that is used only if the destination is a web layer
and
bMakeCopy is true. It specifies how to create Hotspots if multiple items are selected.
Acceptable values for
whatIfMultipleSelected are "single" (creates a single Hotspot that has
the same bounding rectangle as the selection),
"multiple" (creates one Hotspot for each item),
and
"ask user" (displays a dialog box to let the user decide). If whatIfMultipleSelected is
omitted or
null, "ask user" is assumed.
elementIndex A zero-based index, added in Fireworks 4, that specifies the element before
which the moved or copied selection should be inserted. If
elementIndex is omitted, the
selection is placed at the top of the layer (before any other elements). Otherwise, it is an index
within the existing elements in the layer, where
0 is the topmost, and (n-1) is the last element (for
a layer with n elements). The maximum value is the number of elements previously in the layer—
meaning that the elements are moved to the bottom of the specified layer.
Returns
Nothing.
Description
Moves or copies the selection to the specified layer.
dom.moveSelectionToNewLayer()
Availability
Fireworks 3.
Usage
dom.moveSelectionToNewLayer(bMakeCopy)
Arguments
bMakeCopy
If bMakeCopy is true, the selected items are copied instead of moved.
Returns
Nothing.
Description
Makes a new layer with a default name, then moves or copies the selection to that new layer.