User Guide

The toolbar command API 191
getUpdateFrequency()
Availability
Dreamweaver MX.
Description
Specifies how often to run the handlers for the enabled, checked, showIf, and value attributes
to update the visible state of the item.
You must specify the update frequency for toolbar items because they are always visible, unlike
menus. For this reason, you should always select the lowest frequency possible and make sure your
enabled, checked, and value handlers are as simple as possible.
This function is equivalent to the
update attribute in a toolbar item.
Arguments
None.
Returns
Dreamweaver expects a string that contains a comma-separated list of update handlers. For a
complete list of the possible update handlers, see “update="update_frequency_list"” on page 185.
Example
function getUpdateFrequency()
{
return onSelChange”;
}
isCommandChecked()
Availability
Dreamweaver MX.
Description
Returns a value that specifies whether the item is selected. For a button, checked means that the
button appears on or depressed. The
isCommandChecked() function is equivalent to the checked
attribute in a toolbar item tag.
Arguments
For pop-up menus, combo boxes, text boxes, and color pickers, the first argument is the current
value within the control. The
getDynamicContent() function can optionally attach individual
IDs to items within a pop-up menu. If the selected item in the menu has an ID attached,
Dreamweaver passes that ID to the
isCommandChecked() function instead of the value. For
combo boxes, if the current contents of the text box do not match an entry in the pop-up menu,
Dreamweaver passes the contents of the text box. For determining whether the text box matches,
Dreamweaver compares against the menu without case-sensitivity.
If you specified the
arguments attribute, those arguments are passed next. If you do not specify
the
arguments attribute, Dreamweaver passes the ID of the item.