Macromedia dreamweaver 8-extending dreamweaver User Manual

Page of 504
420
Components
toolbarControls()
Availability
Dreamweaver MX.
Description
Every component type returns a list of 
toolBarButtonRec
 objects, which represents the 
toolbar icons, in left-to-right order. Each 
toolBarButtonRec
 object contains the following 
properties:
Arguments
None.
Returns
An array of toolbar buttons in left-to-right order.
Property 
Name
Description
image
Path to image file
disabledImage
Optional; path to disabled image searches for the toolbar button
pressedImage
Optional; path to pressed image searches for the toolbar button
toolTipText
Tooltip for the toolbar button
toolStyle
Left /right 
enabled
JavaScript code that returns a Boolean value (
true
 or 
false
). The enablers 
are called when the following conditions exist: 
• When the 
dreamweaver.serverComponents.refresh()
 function is called
• When the selection in the tree changes
• When server model changes
command
The JavaScript code to execute. The command handler can force a refresh 
using the 
dreamweaver.serverComponents.refresh()
 function.
menuId
The unique menu ID for the pop-up menu button when the button is 
clicked. When this ID is present, it overrides the command handler. In other 
words, the button can be either a button associated with a command, or a 
button that has a pop-up menu associated with it, but not both at the same 
time.