User Guide

The toolbar definition file 175

As with the initiallyVisible attribute, the initialPosition attribute applies only the

first time that Dreamweaver loads the toolbar. After that, the toolbar’s position is saved to the

registry or the Dreamweaver Preferences file. You can reset the position of the toolbar by using

the

dom.setToolbarPosition() function. For more information on the

dom.setToolbarPosition() function, see the Dreamweaver API Reference.

If you do not specify the

initialPosition attribute, Dreamweaver positions the toolbar in

the order that it is encountered during loading.

• relativeTo="toolbar_id" This attribute is required if the initialPosition attribute

specifies

below. Otherwise, it is ignored. Specifies the ID of the toolbar below which this

toolbar should be positioned.

Contents

The toolbar tag contains include, itemref, and separator tags as well as individual item

definitions such as

button, combobox, dropdown, and so on. For descriptions of the item

definitions that you can specify, see “Toolbar item tags” on page 177.

Container

The toolbarset tag.

Example

Description

Loads toolbar items from the specified file before continuing to load the current file. Toolbar

items that are defined in the included file can be referenced in the current file. If a file attempts to

recursively include another file, Dreamweaver displays an error message and ignores the recursive

include. Any

toolbar tags in the included file are skipped, although toolbar items in those

toolbars are available for reference in the current file.

Attributes

• The file path, relative to the Toolbars folder, of the toolbar XML file to include.

Contents

None.

Container

The toolbar tag or the toolbarset tag.

Example