Macromedia dreamweaver 8-extending dreamweaver User Manual

218

Toolbars

A simple toolbar command file

This simple example implements a Title text box item as seen on the Dreamweaver Document 
toolbar. The text box item lets the user enter a name for the current Dreamweaver document. 
You can implement this toolbar example by performing the following steps:

■

■

Creating the text box

To add a toolbar to Dreamweaver, you place an XML file that contains the toolbar definition 
in the Toolbars folder inside the Dreamweaver Configuration folder. 

The following figure shows the Title text box: 

The following toolbar 

editcontrol

 item defines a text box that is labeled Title

:

<EDITCONTROL ID="DW_SetTitle"

label="Title: "
tooltip="Document Title"
width="150"
file="Toolbars/MM/EditTitle.htm"/>

The 

tooltip

 attribute causes Dreamweaver to display Document Title in a tooltip box when 

the user places the mouse pointer over the text box. The 

width

 attribute specifies the size of 

the field in pixels. The 

file

 attribute specifies that the EditTitle.htm file contains the 

JavaScript functions that operate on the text box. To see the full definition of the 
Dreamweaver Document toolbar, see the main toolbar (

id="DW_Toolbar_Main"

) in the 

toolbars.xml file.

Writing the JavaScript code

When the user interacts with the text box, it causes Dreamweaver to invoke the EditTitle.htm 
command file in the Toolbars/MM folder. This file contains three JavaScript functions that 
operate on the Title text box. These functions are 

canAcceptCommand()

, 

receiveArguments()

, and 

getCurrentValue()

.