How Floating Panel Files Work - Adobe 38040334 - Dreamweaver CS3 User Manual

How floating panel files work

Custom floating panels can be moved, resized, and tabbed together the same way as the floating panels that are built
in to Dreamweaver. Custom floating panels differ from built-in floating panels in the following ways:
• Custom floating panels display in the default gray. Setting the
• All custom floating panels either appear always in front of the Document window or float behind it when inactive,
depending on the setting for All Other Floaters in the Panels preferences.
Floating panel files also differ somewhat from other extensions. Unlike other extension files, Dreamweaver does not
load floating panel files into memory at startup unless the floating panels were visible when Dreamweaver last shut
down. If the floating panels were not visible when Dreamweaver shut down, the files that define them are loaded only
when referenced from one of the following functions:
dreamweaver.setFloaterVisibility()
functions, see the Dreamweaver API Reference.
When one of the files inside the Configuration folder calls the
dw.setFloaterVisibility(floaterName)
events occur:
If is not one of the reserved floating panel names, Dreamweaver searches the
1
floaterName
Configuration/Floaters folder for a file called
names, see the
dreamweaver.getFloaterVisibility()
.htm is not found, Dreamweaver searches for
floaterName
If the floating panel file is being loaded for the first time, the
2
defined, to determine the floating panel's default position on the screen, and the
if it is defined, to determine the floating panel's default tab grouping.
The
3
selectionChanged()
probably occurred while the floating panel was hidden.
When the floating panel is visible, the following actions occur:
4
• When the selection changes, the
• When the user makes changes to the document, the
• 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
mentDOM().body.innerHTML=''
document when it is clicked.)
Floating panels support two special events on the
When the user quits Dreamweaver, the current visibility, position, and tab grouping of the floating panel are saved.
5
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.
dreamweaver.getFloaterVisibility()
, or
dreamweaver.toggleFloater()
, or
dw.toggleFloater(floaterName)
floaterName
and functions are called on the assumption that changes
documentEdited()
selectionChanged()
event handler that executes
onClick
removes everything between the opening and closing
tag:
body
attribute in the
bgcolor
. For more information on these
dw.getFloaterVisibility(floaterName)
.htm. (For a complete list of reserved floating panel
function in the Dreamweaver API Reference. If
.html. If no file is found, nothing happens.
floaterName
initialPosition()
initialTabs()
function is called, if it is defined.
function is called, if it is defined.
documentEdited()
dw.getDocu-
and
onShow() onHide()
DREAMWEAVER CS3
Extending Dreamweaver
tag has no effect.
body
,
,
functions, the following
function is called, if it is
function is called,
tags in the
body
.
219