128
Chapter 5: Fireworks JavaScript API
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).
Summary of Contents for DREAMWEAVER MX 2004-EXTENDING DREAMWEAVER
Page 1: ...Extending Fireworks...
Page 4: ...4 Contents...
Page 8: ...8 Chapter 1 Extending Fireworks Overview...
Page 102: ...102 Chapter 4 Auto Shapes...
