Adobe 38040334 Extending Dreamweaver - Page 140

DREAMWEAVER CS3 134 Extending Dreamweaver commandButtons() Description This function defines the buttons that should appear on the right side of the Options dialog box and their behaviors when they are clicked. If this function is not defined, no buttons appear, and the body section of the command file expands to fill the entire dialog box. Arguments None. Returns Dreamweaver expects an array that contains an even number of elements. The first element is a string that contains the label for the topmost button. The second element is a string of JavaScript code that defines the behavior of the topmost button when it is clicked. The remaining elements define additional buttons in the same way. Example The following instance of commandButtons() defines three buttons: OK, Cancel, and Help: function commandButtons(){ return new Array("OK" , "doCommand()" , "Cancel" , ¬ "window.close()" , "Help" , "showHelp()"); } isDOMRequired() Description This function determines whether the command requires a valid DOM to operate. If this function returns a value of true or if the function is not defined, Dreamweaver assumes that the command requires a valid DOM and synchronizes the Design and Code views of the document before executing. Synchronization causes all edits in the Code view to update in the Design view. Arguments None. Returns Dreamweaver expects a true value if a command requires a valid DOM to operate; false otherwise. receiveArguments() Description This function processes any arguments that pass from a menu item or from the dw.runCommand() function. Arguments {arg1}, {arg2},...{argN} • If the arguments attribute is defined for a menuitem tag, the value of that attribute passes to the receiveArguments() function as one or more arguments. Arguments can also pass to a command by the dw.runCommand() function.