57
EXTENDING FIREWORKS
The Document object
Las
t
up
d
a
ted
12/8/2009
Returns
Nothing.
Description
Cuts the selection to the clipboard.
Example
The following command cuts the selected items and places them on the clipboard:
fw.getDocumentDOM().clipCut();
dom.clipPaste()
Availability
Fireworks 3, updated in Fireworks 4.
Usage
dom.clipPaste({
whatIfResolutionDifferent
}, {
whatIfPastingIntoElementMask
})
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.
