Specifications

Chapter 880
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 toolbar item attributes that are described in the following sections.
<?xml version="1.0"?>
<!DOCTYPE toolbarset SYSTEM "-//Macromedia//DWExtension toolbar 5.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 section describes 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 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 given file; this also
applies to all files that are included by that file. The JavaScript API functions that manipulate a
toolbar refer to it by its ID. For more information on these functions, see “Toolbar functions” on
page 637. If two toolbars that are included in the same file have the same ID, Dreamweaver
displays an error.
label="string" Required. The name of the toolbar 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.
container="mainframe" or "document" Defaults to "mainframe". Specifies where the toolbar
should dock in the Dreamweaver MX workspace on Windows. If set to
"mainframe", the toolbar
appears in the outer Dreamweaver MX workspace frame and operates on the front document. If it
is set to
"document", the toolbar appears in each document window. In the Dreamweaver 4
workspace and on the Macintosh, all toolbars appear in each document window.