
402 Server Formats
When the data formatting functions
are called
The data formatting functions are called in the following scenarios:
■ In the Dynamic Data or the Dynamic Text dialog box, the user selects a node from the
data source tree and a format from the Format menu. When the user selects the format,
Dreamweaver calls the
generateDynamicDataRef() function and passes the return value
from the
generateDynamicDataRef() function to the formatDynamicDataRef()
function. The return value from the
formatDynamicDataRef() function appears in the
Code setting of the dialog box. After the user clicks OK, the string of code is inserted into
the user’s document. Next, Dreamweaver calls the
applyFormat() function to insert a
function declaration. For more information, see “generateDynamicDataRef()”
on page 394. A similar process occurs when the user works with the Bindings panel.
■ If the user changes the format or deletes the dynamic data item, the deleteFormat()
function is called. The
deleteFormat() function removes the support scripts from the
document.
■ When the user clicks the Plus (+) button in the Edit Format List dialog box, Dreamweaver
displays a menu that contains all the format types for the specified server model. Each
format type corresponds to a file in the Configuration/ServerFormats/currentServerModel
folder.
If the user selects a format from the Plus (+) menu that requires a user-specified parameter,
Dreamweaver executes the
onload handler on the body tag and displays the Parameters
dialog box, which shows the parameters for the format type. In this dialog box, when the
user selects parameters for the format and clicks OK, Dreamweaver calls the
applyFormatDefinition() function.
If the selected format does not need to display a Parameters dialog box, Dreamweaver calls
the
applyFormatDefinition() function when the user selects the format type from the
Plus (+) menu.
■ Later, if the user edits the format by selecting it in the Edit Format List dialog box and
clicking the Edit button, Dreamweaver calls the
inspectFormatDefinition() function
before the Parameters dialog box appears, so the form controls can be initialized to the
correct values.
Kommentare zu diesen Handbüchern