Adobe 38039927 Extended User Guide - Page 274

ADOBE FIREWORKS CS3 270 Extending Guide Note: On multiuser systems, Fireworks supports a Command Panels folder inside of each user's Configuration folder, so users can save favorite panels. At runtime, Fireworks starts Flash Player, which either plays Shockwave animations or runs commands (if the user selects the custom command options). The Align panel (Window > Align menu option) is an example of how Flash panels work in the Fireworks interface. Embedding API commands You can call any part of the Fireworks API by embedding the API commands in the following functions. These functions communicate directly with Adobe Flash Player, which is distributed with Fireworks. MMExecute() Usage MMExecute(jsToPass) Arguments jsToPass A string of JavaScript for Fireworks to execute. Returns Nothing. Description Declares a set of JavaScript code to pass to the Fireworks API, allowing Flash authors to embed Fireworks API commands in a frame of a Flash movie. Note: MMExecute supersedes the FWJavascript command. However, the FWJavascript command still works in the current version of Fireworks. The commands should be embedded in the same way that you would write separate JavaScript code blocks to perform similar operations, and you can concatenate lines of JavaScript code into one MMExecute() function. Example The following example concatenates two lines of JavaScript code into one command: MMExecute("dom=fw.getDocumentDOM();dom.addNewRectanglePrimitive({left:47, top:26, right:102, bottom:87}, 0"); MMEndCommand() Usage MMEndCommand(endStatus, notifyString) Arguments endStatus A Boolean value: true to commit changes; false otherwise. If it is set to false, any pending changes are discarded. To commit the changes, endStatus must be set to true. notifyString A string to notify the user of errors. If the value of endStatus is false, this argument holds a string used to notify the user of the error. If endStatus is set to true, notifyString is an empty string.