Adobe 38040334 Extending Dreamweaver - Page 132

Chapter 9: Commands Adobe Dreamweaver CS3 commands can perform almost any kind of edit to a user's current document, other open documents, or any HTML document on a local drive. Commands can insert, remove, or rearrange HTML tags and attributes, comments, and text. Commands are HTML files. The body section of a command file can contain an HTML form that accepts options for the command (for example, how a table should be sorted and by which column). The head section of a command file contains JavaScript functions that process form input from the body section and control what edits are made to the user's document. The following table lists the files you use to create a command: Path Configuration/Commands/ Configuration/Commands/ File commandname.htm commandname.js Description Specifies the user interface. Contains the functions to execute. How commands work When a user clicks a menu that contains a command, the following events occur: 1 Dreamweaver calls the canAcceptCommand() function to determine whether the menu item should be disabled. If the canAcceptCommand() function returns a false value, the command is dimmed in the menu, and the procedure stops. If the canAcceptCommand() function returns a true value, the procedure can continue. 2 The user selects a command from the menu. 3 Dreamweaver calls the receiveArguments() function, if defined, in the selected command file to let the command process any arguments that pass from the menu item or from the dreamweaver.runCommand() function. For more information on the dreamweaver.runCommand() function, see the Dreamweaver API Reference.