receiveArguments()

Availability

Adobe Dreamweaver MX.

Description

Processes any arguments that pass from a toolbar item. The receiveArguments() function is equivalent to the command 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 pop-up menu has an ID attached, Adobe Dreamweaver passes that ID to the receiveArguments() 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, Adobe Dreamweaver passes the contents of the text box. To determine whether the text box matches, Adobe Dreamweaver compares against the pop-up menu without case-sensitivity.

If you specified the arguments attribute, those arguments are passed next. If you did not specify the arguments attribute, Adobe Dreamweaver passes the ID of the item.

Returns

Adobe Dreamweaver expects nothing.

Example

function receiveArguments(newTitle){ var dom = dw.getDocumentDOM(); if (dom) dom.setTitle(newTitle);}