Adobe 38039927 - Fireworks CS3 - PC Extended User Manual page 52

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