Specifications
Chapter 12126
When one of the files inside the Configuration folder calls
dw.getFloaterVisibility(floaterName), dw.setFloaterVisibility(floaterName), or
dw.toggleFloater(floaterName), 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 “dreamweaver.getFloaterVisibility()” on page 644.) 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 defined, to determine the floating panel’s default position on the screen, and
the
initialTabs() function is called, if 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 calls
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.
Dreamweaver MX introduces a new user interface in Windows, known as the Dreamweaver MX
workspace or multiple document interface (MDI). This interface, or type of workspace, is
optional, but it is also the default workspace. In the Dreamweaver MX workspace,
Dreamweaver MX integrates all documents into one parent container in which you can dock all
objects and panels.
If you prefer, in Windows you can choose to work in the Dreamweaver 4 workspace, in which
you manage separate, floating windows. The Dreamweaver 4 workspace is called the classic
workspace.
In Windows, you can switch from one type of workspace to the other through the Preferences
item on the Edit menu.
Some of the functions in this section operate only in the Dreamweaver MX workspace and
only on the Windows operating system. The description of the function indicates whether this
is the case.