User Guide

Behavior functions 373
if (CANBEAPPLIED) {
// display the action UI
} else{
// display a helpful message that tells the user
// that this action can only be applied to a
// hyperlink
}
}
dreamweaver.popupAction()
Availability
Dreamweaver 2.
Description
Invokes a Parameters dialog box for the specified behavior action. To the user, the effect is the
same as selecting the action from the Actions pop-up menu in the Behaviors panel. This
function lets extension files other than actions attach behaviors to objects in the user’s
document. It blocks other edits until the user dismisses the dialog box.
Arguments
actionName, {funcCall}
■ The actionName argument is a string that contains the name of a file in the
Configuration/Behaviors/Actions folder that contains a JavaScript behavior action (for
example,
"Timeline/Play Timeline.htm").
■ The funcCall argument, which is optional, is a string that contains a function call for the
action that is specified in
actionName; for example, "MM_playTimeline(...)". This
argument, if specified, is supplied by the
applyBehavior() function in the action file.
Returns
The function call for the behavior action. When the user clicks OK in the Parameters dialog
box, the behavior is added to the current document (the appropriate functions are added to
the
HEAD section of the document, HTML might be added to the top of the BODY section, and
other edits might be made to the document). The function call (for example,
"MM_playTimeline(...)") is not added to document but becomes the return value of this
function.
NOTE
This function can be called within the objectTag() function or in any script in a
command file or in the Property inspector file.
000_DW_API_Print.book Page 373 Wednesday, July 20, 2005 11:58 AM