Iscommandchecked() – Adobe Extending Dreamweaver CS4 User Manual
Page 195
189
EXTENDING DREAMWEAVER CS4
Toolbars
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"
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.
Returns
Dreamweaver expects a Boolean value:
true
if the item is checked;
false
otherwise.
Example
The following example determines which item, if any, should be checked in a pop-up menu of paragraph formats and
CSS styles: