Adobe 65011817 Extended User Guide - Page 112

Last updated 12/8/2009 EXTENDING FIREWORKS 108 The Document object 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 Boolean. If 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 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 Boolean. If 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. dom.pageName() Availability Fireworks CS3.