MACROMEDIA DREAMWEAVER 8-EXTENDING DREAMWEAVER Manual page 216

Some types of toolbar controls, such as push buttons and pop-up menus, have icon images
associated with them. Icon images are stored in an images folder in the Toolbars folder.
Images can be in any format that Dreamweaver can render but are typically GIF or JPEG file
formats. Images for Macromedia-authored toolbars are stored in the Toolbars/images/MM
folder.
As with menus, you can specify the functionality of individual toolbar items either through
the item attributes or through a command file. Macromedia-authored toolbar command files
are stored in the Toolbars/MM folder.
The Toolbar API is compatible with the Menu Commands API, so toolbar controls can
reuse menu command files.
Unlike menus, you can define toolbar items independently from the toolbars that use them.
This flexibility lets you use toolbar items in multiple toolbars by using the
The first time Dreamweaver loads a toolbar, its visibility and position are set by the toolbar
definition. After that, its visibility and position are saved in and restored from the registry
(Windows) or the Dreamweaver Preferences file (Macintosh).
How toolbars behave
In Windows, Dreamweaver toolbars generally act the same as standard Windows toolbars.
Dreamweaver toolbars have the following characteristics:
You can drag and drop toolbars to dock them, undock them, and reposition them relative
to other toolbars.
You can horizontally dock toolbars to the top or bottom of the frame window.
In the Dreamweaver workspace, which integrates all the Dreamweaver document
windows within a single parent frame, you can specify whether toolbars dock to the
workspace frame or to the document window.
For toolbars that dock to the Dreamweaver workspace frame, there is only one instance of
each toolbar. In this case, the toolbars always operate on the document in front. In the
Dreamweaver workspace, you can dock toolbars above, below, or to the left or right of the
Insert toolbar. Toolbars that are attached to the Dreamweaver workspace frame do not
automatically disable when there is no document window. The toolbar items determine
whether they are enabled when no document is open.
When toolbars stay docked to the document window, there is one instance for each
window. Toolbars that are attached to a document window completely disable themselves
when their window is not the front document and rerun all their update handlers when
their window comes to the front.
216 Toolbars
tag.
itemref