MACROMEDIA FIREWORKS MX 2004-EXTENDING FIREWORKS Manual page 171

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