User Guide

224 Chapter 13: Floating Panels
When one of the files inside the Configuration folder calls the
dw.getFloaterVisibility(floaterName), dw.setFloaterVisibility(floaterName), or
dw.toggleFloater(floaterName) functions, the following events occur:
1 If floaterName is not one of the reserved floating panel names, Dreamweaver searches the
Configuration/Floaters folder for a file called
floaterName.htm. (For a complete list of reserved
floating panel names, see the
dreamweaver.getFloaterVisibility() function in the
Dreamweaver API Reference. If floaterName.htm is not found, Dreamweaver searches for
floaterName.html. If no file is found, nothing happens.
2 If the floating panel file is being loaded for the first time, the initialPosition() function
is called, if it is defined, to determine the floating panel’s default position on the screen, and
the
initialTabs() function is called, if it is defined, to determine the floating panel’s default
tab grouping.
3 The selectionChanged() and documentEdited() functions are called on the assumption that
changes probably occurred while the floating panel was hidden.
4 When the floating panel is visible, the following actions occur:
■ When the selection changes, the selectionChanged() function is called, if it is defined.
■ When the user makes changes to the document, the documentEdited() function is called,
if it is defined.
■ Event handlers that are attached to the fields in the floating panel interface execute as the
user encounters them. (For example, a button with an
onClick event handler that executes
dw.getDocumentDOM().body.innerHTML='' removes everything between the opening and
closing
BODY tags in the document when it is clicked.)
5 When the user quits Dreamweaver, the current visibility, position, and tab grouping of the
floating panel are saved. The next time Dreamweaver starts up, it loads the floating panel files
for any floating panels that were visible at the last shutdown and displays the floating panels in
their last position and tab grouping.
The Floating panel API
All the custom functions in the Floating panel API are optional.
Some of the functions in this section operate only on the Windows operating system. The
description of the function indicates whether this is the case.
displayHelp()
Description
If this function is defined, a Help button appears below the OK and Cancel buttons in your
dialog box. This function is called when the user clicks the Help button.
Arguments
None.
Returns
Dreamweaver expects nothing.