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

ADOBE FIREWORKS CS3 28
Extending Guide
Arguments
Acceptable values for are " and
mode mode reveal all", "hide all", "reveal selection",
. If the user is not in bitmap mode, or if there is no pixel selection, and
"hide selection" "reveal selection"
operate the same as and , respectively.
"hide selection" "reveal all" "hide all"
If (optional) is set to , Fireworks enters mask-edit mode on the
bEnterMaskEditMode bEnterMaskEditMode true
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
An integer that specifies how many frames to add.
howMany
The location where frames should be added. Acceptable values for are ,
where where "beginning" "before
, , and .
current" "after current" "end"
Added in Fireworks 4, specifies whether to change the active frame. If it is omitted or
bAdvanceActiveFrame
, this function sets the active frame to the first frame added. If , the active frame does not change. For
true false
example, if the user is adding frames at the end of a document that has two frames and is
bAdvanceActiveFrame
omitted or , then the third frame becomes the active frame.
true
Returns
Nothing.
Description
Adds one or more frames to the document.
Example
The following command adds one frame after the current frame but does not change the active frame:
fw.getDocumentDOM().addFrames(1, "after current", false);
dom.addGuide()
Availability
Fireworks 3.