MACROMEDIA FIREWORKS 8-EXTENDING FIREWORKS Manual page 162

whatIfPastingIntoElementMask
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
whatIfPastingIntoElementMask
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
resolution of the Clipboard contents doesn't match the resolution of the document.
Acceptable values for
and (displays a dialog box to let the user decide). If
"ask user"
whatIfResolutionDifferent
Specifies how to paste the mask. Acceptable values are "
masktype
an image mask), "
vector
let the user decide). If the Clipboard contains a single image, it is pasted as an image mask,
even if you pass "
vector
162 Fireworks JavaScript API
An optional argument, added in Fireworks 4, that
are
"image", "vector",
is omitted or
A string that specifies how resampling should be done if the
whatIfResolutionDifferent
is omitted or
" (always paste as a vector mask), and "
".
and
,
null "ask user"
are
"resample"
, is assumed.
null "ask user"
ask
. If
"ask user"
is assumed.
,
"do not resample"
" (always paste as
image
" (displays a dialog box to
,