Adobe 38040334 - Dreamweaver CS3 User Manual page 169

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 Adobe-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. Adobe-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 commands 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.
You cannot drag and drop toolbars between the document window and the Dreamweaver workspace frame.
• Toolbars remain a fixed size. A toolbar does not shrink if the container shrinks or if other toolbars are placed next
to it.
• You can show or hide toolbars from the View >Toolbars menu.
• Toolbars cannot overlap.
• Only the outline of the toolbar appears while you drag it.
On the Macintosh, toolbars are always attached to the document window. They can be shown or hidden from the
menu, but you cannot drag and drop, rearrange, or undock them.
How toolbar commands work
When Dreamweaver draws a toolbar, the following events occur:
tag.
itemref
DREAMWEAVER CS3 163
Extending Dreamweaver