How commands work

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.

The user selects a command from the menu.

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.

Dreamweaver calls the commandButtons() function, if defined, to determine which buttons appear on the right side of the Options dialog box and what code should execute when the user clicks the buttons.

Dreamweaver scans the command file for a form tag. If a form exists, Dreamweaver calls the windowDimensions() function, which sizes the Options dialog box that contains the body elements of the file. If the windowDimensions() function is not defined, Dreamweaver automatically sizes the dialog box.

If the command file’s body tag contains an onLoad handler, Dreamweaver executes it (whether or not a dialog box appears). If no dialog box appears, the remaining steps do not occur.

The user selects options for the command. Dreamweaver executes event handlers that are associated with the fields as the user encounters them.

The user clicks one of the buttons that is defined by the commandButtons() function.

Dreamweaver executes the associated code. The dialog box remains visible until one of the scripts in the command calls the window.close() function.