The Edit Format List Plus (+) Menu; When The Data Formatting Functions Are Called - MACROMEDIA DREAMWEAVER MX 2004-EXTENDING DREAMWEAVER 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, Configuration/ServerFormats/ASP/
ServerFormats.xml). 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
from the
generateDynamicDataRef()
The return value from the
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
when the user works with the Bindings panel.
•
If the user changes the format or deletes the dynamic data item, the
is called. The
•
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
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()
If the selected format does not need to display a Parameters dialog box, Dreamweaver calls the
applyFormatDefinition()
(+) 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
Parameters dialog box appears, so the form controls can be initialized to the correct values.
generateDynamicDataRef()
formatDynamicDataRef()
applyFormat()
"generateDynamicDataRef()" on page
function removes the support scripts from the document.
deleteFormat()
handler on the
onload
function.
function when the user selects the format type from the Plus
function and passes the return value
function to the
formatDynamicDataRef()
function appears in the Code setting of
function to insert a function declaration. For
297. A similar process occurs
tag and displays the Parameters dialog
body
inspectFormatDefinition()
When the data formatting functions are called
function.
function
deleteFormat()
function before the
309