Inspectserverbehavior(), Pasteserverbehavior() – Adobe Extending Dreamweaver CS4 User Manual

Page 261

Advertising
background image

255

EXTENDING DREAMWEAVER CS4

Server behaviors

Returns
Dreamweaver expects an array of JavaScript objects; the length of the array is equal to the number of behavior instances
that are found in the page.

inspectServerBehavior()

Availability
Dreamweaver UltraDev 1.

Description
Determines the settings for the Server Behaviors dialog box, based on the specified behavior object. Dreamweaver calls
the

inspectServerBehavior()

function when a user opens a Server Behaviors dialog box. Dreamweaver calls this

function only when a user edits an existing behavior.

Arguments
serverBehavior

The serverBehavior argument is a JavaScript object that represents the behavior. It is the same object that

findServerBehaviors()

returns.

Returns
Dreamweaver expects nothing.

pasteServerBehavior()

Availability
Dreamweaver UltraDev 1.

Description
If this function is implemented, users can paste instances of the specified server behavior using the

pasteServerBehavior()

function. When the user pastes the server behavior, Dreamweaver organizes the contents

of the Clipboard and generates a new behavior object. The new object is identical to the original, except that it lacks
pointer properties. Dreamweaver passes the new behavior object to the

pasteServerBehavior()

function. The

pasteServerBehavior()

function relies on the properties of the behavior object to determine what to add to the

user’s document. The

pasteServerBehavior()

function then adds the behavior to the user’s document. After

pasteServerBehavior()

returns, Dreamweaver calls the

findServerBehaviors()

functions to get a new list of all

the server behaviors in the user’s document.

Implementing the

pasteServerBehavior()

function is optional. For more information, see “

Scenarios in which the

server behavior API functions are called

” on page 249.

Note: If you implement this function, you must also implement the copyServerBehavior() function.

Arguments
behavior

The behavior JavaScript object represents the behavior.

Advertising
This manual is related to the following products: