Adobe 38040334 - Dreamweaver CS3 User Manual page 173

<menubutton id="DW_Preview" . . ./>
<separator/>
<button id="DW_DocRefresh" . . ./>
<button id="DW_Reference" . . ./>
<menubutton id="DW_CodeNav" . . ./>
<menubutton id="DW_ViewOptions" . . ./>
</toolbar>
</toolbarset>
The following section describes each of the toolbar tags.
<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}
• Required. An identifier string must be unique within a file and within all files that the file
id="unique_id"
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.
•
Required. The label attribute specifies the label, which is a character string, that Dreamweaver
label="string"
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"
the Dreamweaver workspace on Windows. If the container is set to
workspace frame and operates on the front document. If the container is set to
in each document window. On the Macintosh, all toolbars appear in each document window.
•
initiallyVisible="true"
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
functions, as described in the Dreamweaver API Reference. If you do not set the
barVisibility()
attribute, it defaults to
Visible
•
initialPosition="top"
toolbar, relative to other toolbars, the first time that Dreamweaver loads it. The possible values for
are described in the following list:
intialPosition
•
This is the default position, so the toolbar appears at the top of the document window. If multiple toolbars
top
specify for a given window type, the toolbars appear in the order that Dreamweaver encounters them
top
during loading, which might not be predictable, if the toolbars reside in separate files.
Defaults to
or
"document"
or . This tag specifies whether the toolbar should be visible the first time
"false"
.
true
, , or
"below" "floating"
. Specifies where the toolbar should dock in
"mainframe"
"mainframe"
"document"
dom.getToolbarVisibility()
. Specifies where Dreamweaver initially positions the
DREAMWEAVER CS3
Extending Dreamweaver
, the toolbar appears in the outer
, the toolbar appears
and
dom.setTool-
initially-
167