Adobe Extending Dreamweaver CS4 User Manual
Page 178
172
EXTENDING DREAMWEAVER CS4
Toolbars
•
container="mainframe"
or
"document"
Defaults to
"mainframe"
. Specifies where the toolbar should dock in
the Dreamweaver workspace on Windows. If the container is set to
"mainframe"
, the toolbar appears in the outer
workspace frame and operates on the front document. If the container is set to
"document"
, the toolbar appears in
each document window. On the Macintosh, all toolbars appear in each document window.
•
initiallyVisible="true"
or
"false"
. This tag specifies whether the toolbar should be visible the first time that
Dreamweaver loads it from the Toolbars folder. After the first time, the user controls visibility. Dreamweaver saves
the current state to the system registry (Windows) or the Dreamweaver Preferences file (Macintosh) when the user
quits Dreamweaver. Dreamweaver restores the setting from the registry or the Preferences file when it restarts. You
can manipulate toolbar visibility using the
dom.getToolbarVisibility()
and
dom.setToolbarVisibility()
functions, as described in the Dreamweaver API Reference. If you do not set the
initiallyVisible
attribute, it
defaults to
true
.
•
initialPosition="top"
,
"below"
, or
"floating"
. Specifies where Dreamweaver initially positions the toolbar,
relative to other toolbars, the first time that Dreamweaver loads it. The possible values for
intialPosition
are
described in the following list:
•
top
This is the default position, so the toolbar appears at the top of the document window. If multiple toolbars
specify
top
for a given window type, the toolbars appear in the order that Dreamweaver encounters them during
loading, which might not be predictable, if the toolbars reside in separate files.
•
below
The toolbar appears at the beginning of the row immediately below the toolbar that the
relativeTo
attribute specifies. Dreamweaver reports an error if the
relativeTo
toolbar isn’t found. If multiple toolbars specify
below
relative to the same toolbar, they appear in the order that Dreamweaver encounters them during loading,
which might not be predictable if the toolbars reside in separate files.
•
floating
Toolbar is not initially docked to the window; it floats above the document. Dreamweaver automatically
places the toolbar so it is offset from other floating toolbars. On the Macintosh,
floating
is treated the same as
top
.
As with the
initiallyVisible
attribute, the
initialPosition
attribute applies only the first time that
Dreamweaver loads the toolbar. After that, the toolbar’s position is saved to the registry or the Dreamweaver
Preferences file. You can reset the position of the toolbar by using the
dom.setToolbarPosition()
function. For
more information on the
dom.setToolbarPosition()
function, see the Dreamweaver API Reference.
If you do not specify the
initialPosition
attribute, Dreamweaver positions the toolbar in the order that it is
encountered during loading.
•
relativeTo="toolbar_id"
This attribute is required if the
initialPosition
attribute specifies
below
.
Otherwise, it is ignored. Specifies the ID of the toolbar below which this toolbar should be positioned.
Contents
The
toolbar
tag contains
include
,
itemref
, and
separator
tags as well as individual item definitions such as
button
,
combobox
,
dropdown
, and so on. For descriptions of the item definitions that you can specify, see “
Container
The
toolbarset
tag.
Example