Adobe 38040334 - Dreamweaver CS3 User Manual page 190

DREAMWEAVER CS3
184
Extending Dreamweaver
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 178.
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 function is equivalent to the attribute in a toolbar item tag.
isCommandChecked() checked
Arguments
For pop-up menus, combo boxes, text boxes, and color pickers, the first argument is the current value within the
control. The function can optionally attach individual IDs to items within a pop-up menu.
getDynamicContent()
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 attribute, those arguments are passed next. If you do not specify the
arguments arguments
attribute, Dreamweaver passes the ID of the item.
Returns
Dreamweaver expects a Boolean value: if the item is checked; otherwise.
true false
Example
The following example determines which item, if any, should be checked in a pop-up menu of paragraph formats
and CSS styles: