Adobe Extending Dreamweaver CS4 - Manual (Page 177)

171 EXTENDING DREAMWEAVER CS4
Toolbars
After the declarations, the file consists of a single toolbarset tag, which contains any number of the following tags:
toolbar , itemref , separator , include , and itemtype tags, where itemtype is a button , checkbutton ,
radiobutton , menubutton , dropdown , combobox , editcontrol , or colorpicker . The following example, which is
an abbreviated excerpt from the toolbars.xml file, illustrates the hierarchy of tags in the toolbar file. The example
substitutes ellipses (. . .) for the description of the toolbar item attributes.
<?xml version="1.0"?>
<!DOCTYPE toolbarset SYSTEM "-//Adobe//DWExtension toolbar 10.0">
<toolbarset>
<!-- main toolbar -->
<toolbar id="DW_Toolbar_Main" label="Document">
<radiobutton id="DW_CodeView" . . ./>
<radiobutton id="DW_SplitView" . . ./>
<radiobutton id="DW_DesignView" . . ./>
<separator/>
<checkbutton id="DW_LiveDebug" . . ./>
<checkbutton id="DW_LiveDataView" . . ./>
<separator/>
<editcontrol id="DW_SetTitle" . . ./>
<menubutton id="DW_FileTransfer" . . ./>
<menubutton id="DW_Preview" . . ./>
<separator/>
<button id="DW_DocRefresh" . . ./>
<button id="DW_Reference" . . ./>
<menubutton id="DW_CodeNav" . . ./>
<menubutton id="DW_ViewOptions" . . ./>
</toolbar>
</toolbarset>
The following are descriptions of each of the toolbar tags.
<toolbar>
Description
Defines a toolbar. Dreamweaver displays the items and separators from left to right in the specified order, laying out
the items automatically. The toolbar file does not specify control over the spacing between the items, but you can
specify the widths of certain kinds of items.
Attributes
id, label, {container}, {initiallyVisible}, {initialPosition}, {relativeTo}
• id="unique_id" Required. An identifier string must be unique within a file and within all files that the file
includes. The JavaScript API functions that manipulate a toolbar refer to it by its ID. For more information on these
functions, see the Dreamweaver API Reference. If two toolbars that are included in the same file have the same ID,
Dreamweaver displays an error.
• label="string" Required. The label attribute specifies the label, which is a character string, that Dreamweaver
displays to the user. The label appears in the View >Toolbars menu and in the title bar of the toolbar when it’s
floating.