User Guide

Document functions 109
dom.addElementMask()
Availability
Fireworks 4.
Usage
dom.addElementMask(mode, {bEnterMaskEditMode}
Arguments
mode
Acceptable values for mode are "reveal all", "hide all", "reveal selection",
and "hide selection". If the user is not in bitmap mode, or if there is no pixel
selection,
"reveal selection" and "hide selection" operate the same as "reveal all"
and "hide all", respectively.
bEnterMaskEditMode If bEnterMaskEditMode (optional) is se to true, Fireworks enters mask-
edit mode on the newly added mask; if omitted, it defaults to
false.
Returns
Nothing.
Description
Adds a new empty mask to the selected element. If the selection already has an element mask, it
is replaced with the new one. Only one element can be selected when calling this function. If
selecting more than one element (or none) at the time this function is called, Fireworks throws
an exception.
dom.addFrames()
Availability
Fireworks 3, enhanced in Fireworks 4.
Usage
dom.addFrames(howMany, where, {bAdvanceActiveFrame})
Arguments
howMany
An integer that specifies how many frames to add.
where The location where frames should be added. Acceptable values for where are
"beginning", "before current", "after current", and "end".
bAdvanceActiveFrame Added in Fireworks 4, specifies whether to change the active frame. If
it is omitted or
true, this function sets the active frame to the first frame added. If false, the
active frame does not change. For example, if the user is adding frames at the end of a document
that has two frames and
bAdvanceActiveFrame is omitted or true, then the third frame becomes
the active frame.
Returns
Nothing.
Description
Adds one or more frames to the document.