Adobe 38039927 Extended User Guide - Page 52

ADOBE FIREWORKS CS3 48 Extending Guide 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. Usage dom.clipPasteAsMask(whatIfResolutionDifferent, masktype, maskReplaceOptions) Arguments whatIfResolutionDifferent A 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. masktype Specifies how to paste the mask. Acceptable values are "image" (always paste as an image mask), "vector" (always paste as a vector mask), and "ask" (displays a dialog box to let the user decide). If the Clipboard contains a single image, it is pasted as an image mask, even if you pass "vector". maskReplaceOptions Acceptable values for maskReplaceOptions are "replace" (if an element mask already exists, replace it with the pasted one), "add" (if an element mask already exists, add the pasted mask to it), and "ask" (displays a dialog box to let the user decide). Returns Nothing.