beautypg.com

Dom.addbehavior(), Dom.getbehavior() – Adobe Dreamweaver API Reference CS5 User Manual

Page 317

background image

312

DREAMWEAVER API REFERENCE

Page content

Last updated 8/27/2013

dom.addBehavior()

Availability
Dreamweaver 3.

Description
Adds a new event/action pair to the selected element. This function is valid only for the active document.

Arguments
event, action, {eventBasedIndex}

The event argument is the JavaScript event handler that should attach the behavior to the element (for example,

onClick

,

onMouseOver

, or

onLoad)

.

The action argument is the function call that

applyBehavior()

returns if the action is added using the Behaviors

panel (for example,

"MM_popupMsg('Hello World')")

.

The eventBasedIndex argument, which is optional, is the position at which this action should be added. The
eventBasedIndex argument is a zero-based index; if two actions already are associated with the specified event, and
you specify eventBasedIndex as 1, this action executes between the other two. If you omit this argument, the action
is added after all existing actions for the specified event.

Returns
Nothing.

dom.getBehavior()

Availability
Dreamweaver 3.

Description
Gets the action at the specified position within the specified event. This function acts on the current selection and is
valid only for the active document.

Arguments
event, {eventBasedIndex}

The event argument is the JavaScript event handler through which the action is attached to the element (for
example,

onClick

,

onMouseOver

, or

onLoad

).

The eventBasedIndex argument, which is optional, is the position of the action to get. For example, if two actions
are associated with the specified event, 0 is first and 1 is second. If you omit this argument, the function returns all
the actions for the specified event.

Returns
A string that represents the function call (for example,

"MM_swapImage('document.Image1','document.Image1','foo.gif','#933292969950')"

) or an array of

strings if eventBasedIndex is omitted.