MACROMEDIA DREAMWEAVER MX 2004-EXTENDING DREAMWEAVER, Manual

Page: 171 / 296

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.