Macromedia dreamweaver 8-extending dreamweaver User Manual

The Server Behavior API

331

canApplyServerBehavior()

Availability

Dreamweaver UltraDev 1.

Description

Determines whether a behavior can be applied. Dreamweaver calls this function before the 
Server Behaviors dialog box appears. If this function returns a 

true

 value, the Server 

Behaviors dialog box appears. If this function returns a 

false

 value, the Server Behaviors 

dialog box does not appear and the attempt to add a server behavior stops.

Arguments

■

The 

 JavaScript object represents the behavior; it is necessary to modify 

an existing behavior. If this is a new behavior, the argument is 

null

. 

Returns

Dreamweaver expects a Boolean value: 

true

 if the behavior can be applied; 

false

 otherwise.

copyServerBehavior()

Availability

Dreamweaver UltraDev 1.

Description

Implementing the 

copyServerBehavior()

 function is optional. Users can copy instances of 

the specified server behavior. In the following example, this function is implemented for 
recordsets. If a user selects a recordset in the Server Behaviors panel or the Data Binding 
panel, using the Copy command copies the behavior to the Clipboard; using the Cut 
command cuts the behavior to the Clipboard. For server behaviors that do not implement this 
function, the Copy and Cut commands do nothing. For more information, see 

.

The 

copyServerBehavior()

 function should rely only on behavior object properties that 

can be converted into strings to exchange information with the 

pasteServerBehavior()

 

function. The Clipboard stores only raw text, so 

participant

 nodes in the document should 

be resolved and the resulting raw text should be saved into a secondary property. 

NOT

E

The 

pasteServerBehavior()

 function must also be implemented to let the user paste the 

behavior into any Dreamweaver document.