Adobe 65011817 Extended User Guide - Page 61

Last updated 12/8/2009 EXTENDING FIREWORKS 57 The Document object Returns Nothing. Description Cuts the selection to the clipboard. Example The following command cuts the selected items and places them on the clipboard: fw.getDocumentDOM().clipCut(); dom.clipPaste() Availability Fireworks 3, updated in Fireworks 4. Usage dom.clipPaste({whatIfResolutionDifferent}, {whatIfPastingIntoElementMask}) Arguments whatIfResolutionDifferent An optional string that specifies how resampling should be done if the resolution of the clipboard contents doesn't match the resolution of the document. Acceptable values for whatIfResolutionDifferent are "resample", "do not resample", and "ask user" (displays a dialog box to let the user decide). If whatIfResolutionDifferent is omitted or null, "ask user" is assumed. whatIfPastingIntoElementMask An optional argument, added in Fireworks 4, that applies only if the user is editing an element mask, and that element mask is an empty image mask. In this case, the pasted elements replace the existing mask (because it is essentially a mask that doesn't mask anything). If the image mask isn't empty, the pasted elements are added to the existing mask, rather than replacing it. Acceptable values for whatIfPastingIntoElementMask are "image", "vector", and "ask user". If whatIfPastingIntoElementMask is omitted or null, "ask user" is assumed. Returns Nothing. Description Pastes the clipboard contents into the document. Example The following command pastes the clipboard contents into the document. If there is a need for resampling, Fireworks asks the user to decide how to resample. fw.getDocumentDOM().clipPaste(); dom.clipPasteAsMask() Availability Fireworks 4.