User Guide

252 Chapter 15: Server Behaviors
If you do not want a file that is in the ServerBehaviors folder to appear in the menu, put the
following statement on the first line in the HTML file:
<!-- MENU-LOCATION=NONE -->
• When the user selects an item from the menu, the canApplyServerBehavior() function is
called. If that function returns a
true value, a dialog box appears. When the user clicks OK,
the
applyServerBehavior() function is called.
• If the user edits an existing server behavior by double-clicking it, Dreamweaver displays the
dialog box, executes the
onLoad handler on the BODY tag, if one exists, and then calls the
inspectServerBehavior() function. The inspectServerBehavior() function populates
the form elements with the current parameter values. When the user clicks OK, Dreamweaver
calls the
applyServerBehavior() function again.
• If the user clicks the Minus (-) button, the deleteServerBehavior() function is called. The
deleteServerBehavior() function removes the behavior from the document.
• When the user selects a server behavior and uses the Cut or Copy commands, Dreamweaver
passes the object that represents the server behavior to its
copyServerBehavior() function.
The
copyServerBehavior() function adds any other properties to the server behavior object
that are needed to paste it later.
After the
copyServerBehavior() function returns, Dreamweaver converts the server behavior
object to a form that can be put on the Clipboard. When Dreamweaver converts the object, it
deletes all the properties that reference objects; every property on the object that is not a
number, Boolean value, or string is lost.
When the user uses the Paste command, Dreamweaver unpacks the contents of the Clipboard
and generates a new server behavior object. The new object is identical to the original, except
that it does not have properties that reference objects. Dreamweaver passes the new server
behavior object to the
pasteServerBehavior() function. The pasteServerBehavior()
function adds the behavior to the user’s document. After the
pasteServerBehavior()
function returns, Dreamweaver calls the
findServerBehaviors() function to get a new list of
all the server behaviors in the user’s document.
Users can copy and paste behaviors from one document to another. The
copyServerBehavior()
and
pasteServerBehavior() functions should rely only on properties on the behavior object to
exchange information.