Toolbar - MACROMEDIA DREAMWEAVER MX 2004-EXTENDING DREAMWEAVER Manual

<toolbar>
Description
Defines a toolbar. Dreamweaver displays the items and separators from left to right in the
specified order, laying out the items automatically. The toolbar file does not specify control over
the spacing between the items, but you can specify the widths of certain kinds of items.
Attributes
id, label, {container}, {initiallyVisible}, {initialPosition}, {relativeTo}
•
id="unique_id"
files that the file includes. The JavaScript API functions that manipulate a toolbar refer to it by
its ID. For more information on these functions, see the Dreamweaver API Reference. If two
toolbars that are included in the same file have the same ID, Dreamweaver displays an error.
•
label="string"
that Dreamweaver displays to the user. The label appears in the View >Toolbars menu and in
the title bar of the toolbar when it's floating.
•
container="mainframe"
toolbar should dock in the Dreamweaver workspace on Windows. If the container is set to
"mainframe"
document. If the container is set to
window. On the Macintosh, all toolbars appear in each document window.
•
initiallyVisible="true"
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.setToolbarVisibility()
you do not set the
•
initialPosition="top"
positions the toolbar, relative to other toolbars, the first time that Dreamweaver loads it. The
possible values for
This is the default position, so the toolbar appears at the top of the document window.
top
If multiple toolbars specify
that Dreamweaver encounters them during loading, which might not be predictable, if the
toolbars reside in separate files.
The toolbar appears at the beginning of the row immediately below the toolbar that
below
the
relativeTo
toolbar isn't found. If multiple toolbars specify
appear in the order that Dreamweaver encounters them during loading, which might not be
predictable if the toolbars reside in separate files.
floating
Dreamweaver automatically places the toolbar so it is offset from other floating toolbars. On
the Macintosh,
174 Chapter 9: Toolbars
Required. An identifier string must be unique within a file and within all
Required. The label attribute specifies the label, which is a character string,
or
"document"
, the toolbar appears in the outer workspace frame and operates on the front
or
"false"
functions, as described in the Dreamweaver API Reference. If
initiallyVisible
,
"below"
intialPosition
for a given window type, the toolbars appear in the order
top
attribute specifies. Dreamweaver reports an error if the
Toolbar is not initially docked to the window; it floats above the document.
is treated the same as
floating
Defaults to
"mainframe"
, the toolbar appears in each document
"document"
. This tag specifies whether the toolbar should be
dom.getToolbarVisibility()
attribute, it defaults to
, or . Specifies where Dreamweaver initially
"floating"
are described in the following list:
relative to the same toolbar, they
below
.
top
. Specifies where the
.
true
relativeTo
and