User Guide

Behavior functions 307
Returns
A string that represents the source of the tag. This is the same string that passes as an argument
(
HTMLelement) to the canAcceptBehavior() function. If this function appears outside an action
file, the return value is an empty string.
Example
If you write an action that can be applied only to a hypertext link (A HREF), you can use the
getBehaviorTag() function, as the following example shows, in the function that initializes the
user interface for the Parameters dialog box:
function initializeUI(){
var theTag = dreamweaver.getBehaviorTag().toUpperCase();
var CANBEAPPLIED = (theTag.indexOf('HREF') != -1));
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.
Note: This function can be called within the objectTag() function or in any script in a command file or
in the Property inspector file.
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.
000_DW_API_Print.book Page 307 Wednesday, August 20, 2003 9:14 AM