MACROMEDIA FIREWORKS MX 2004-EXTENDING FIREWORKS Manual page 128

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