Adobe Extending Dreamweaver CS4 - Manual (Page 192)

186 EXTENDING DREAMWEAVER CS4
Toolbars
Example
function canAcceptCommand()
{
return (dw.getDocumentDOM() != null);
}
getCurrentValue()
Availability
Dreamweaver MX.
Description
Returns the current value to display in the item. Dreamweaver calls the
getCurrentValue() function for pop-up
menus, combo boxes, text boxes, and color pickers. For pop-up menus, the current value should be one of the items
in the menu. If the value is not in the pop-up menu, Dreamweaver selects the first item. For combo boxes and text
boxes, this value can be any string that the function returns. For color pickers, the value should be a valid color, but
Dreamweaver does not enforce this. This function is equivalent to the
value attribute.
Arguments
None.
Returns
Dreamweaver expects a string that contains the current value to display. For the color picker, the string contains the
RGB form of the selected color (for example, #FFFFFF for the color white).
Example
function getCurrentValue()
{
var title = "";
var dom = dw.getDocumentDOM();
if (dom)
title = dom.getTitle();
return title;
}
getDynamicContent()
Availability
Dreamweaver MX.
Description
This function is required for pop-up menus and combo boxes. As with menus, this function returns an array of strings
that populate the pop-up menu. Each string can optionally end with
";id=id" . If an ID is specified, Dreamweaver
passes the ID to the receiveArguments() function instead of the actual string to appear in the menu.