Adobe 38039927 Extended User Guide - Page 32

ADOBE FIREWORKS CS3 28 Extending Guide 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 set 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. 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.