Adobe Extending Dreamweaver CS4 - Manual (Page 181)

175 EXTENDING DREAMWEAVER CS4
Toolbars
Toolbar item tags
Each type of toolbar item has its own tag and set of required and optional attributes. You can define toolbar items
either inside or outside of toolbars. In general, it is better to define them outside of toolbars and refer to them within
toolbars using the
itemref tag.
You can define the following types of items in a toolbar.
<button>
Description
This push button executes a specific command when you click it. It looks and acts the same as the Reference button
on the Dreamweaver toolbar.
Attributes
id, image, tooltip, command, {showIf}, {disabledImage}, {overImage}, {label}, {file},
{domRequired}, {enabled}, {update}, {arguments}
For a description of each attribute, see “ Item tag attributes ” on page 180.
Contents
None.
Container
The
toolbar tag or the toolbarset tag.
Example
<BUTTON ID="DW_DocRefresh"
image="Toolbars/images/MM/refresh.gif"
disabledImage="Toolbars/images/MM/refresh_dis.gif"
tooltip="Refresh Design View (F5)"
enabled="((dw.getDocumentDOM() != null) && (dw.getDocumentDOM().getView() != 'browse')
&& (!dw.getDocumentDOM().isDesignViewUpdated()))"
command="dw.getDocumentDOM().synchronizeDocument()"
update="onViewChange,onCodeViewSyncChange"/>
<checkbutton>
Description
A check button is a button that has a checked or unchecked state and that executes a specific command when clicked.
When it is checked, it appears pressed in and highlighted. When it is not checked, it appears flat. Dreamweaver
implements the following states for the check button: Mouse-over, Pressed, Mouse-over-while-pressed, and Disabled-
while-pressed. The handler that is specified by the
checked attribute or the isCommandChecked() function must
ensure that clicking the check button causes the button’s state to toggle.
Attributes
id, {showIf}, image, {disabledImage}, {overImage}, tooltip, {label}, {file}, {domRequired},
{enabled}, checked, {update}, command, {arguments}