When The Data Formatting Functions Are Called - Adobe 38040334 - Dreamweaver CS3 User Manual

The Edit Format List Plus (+) menu
If you do not want a file in the ServerFormats folder to appear in the Edit Format List Plus (+) menu, add the
following statement as the first line of the HTML file:
<!-- MENU-LOCATION=NONE -->
To determine the contents of the menu, Dreamweaver first searches for a ServerFormats.xml file in the same folder
as the data formats (for example, in Configuration/ServerFormats/ASP/). The ServerFormats.xml file describes the
contents of the Edit Format List Plus (+) menu, and it contains references to the HTML files that it lists in the menu.
Dreamweaver checks each referenced HTML file for a title tag. If the file contains a title tag, the content of the title
tag appears in the menu. If the file does not contain a title tag, the filename is used in the menu.
After Dreamweaver finishes searching for the file, or if the file does not exist, Dreamweaver scans the rest of the
folder to find other items that should appear in the menu. If Dreamweaver finds files in the main folder that aren't
already in the menu, it adds them. If subfolders contain files that aren't already in the menu, Dreamweaver creates a
submenu and adds those files to it.

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 to 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
more information, see "generateDynamicDataRef()" on page
with the Bindings panel.
• If the user changes the format or deletes the dynamic data item, the
function removes the support scripts from the document.
deleteFormat()
• 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 handler on the
onload
format type. In this dialog box, when the user selects parameters for the format and clicks OK, Dreamweaver calls
the
applyFormatDefinition()
If the selected format does not need to display a Parameters dialog box, Dreamweaver calls the
applyFormatDefinition()
• 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()
form controls can be initialized to the correct values.
function and passes the return value from the
function. The return value from the
applyFormat()
tag and displays the Parameters dialog box, which shows the parameters for the
body
function.
function when the user selects the format type from the Plus (+) menu.
generateDynamicDataRef()
formatDynamicDataRef()
function to insert a function declaration. For
298. A similar process occurs when the user works
deleteFormat()
function before the Parameters dialog box appears, so the
DREAMWEAVER CS3
Extending Dreamweaver
function is called. The
302