Dom.settoolbarvisibility() – Adobe Dreamweaver API Reference CS5 User Manual
Page 181
176
DREAMWEAVER API REFERENCE
Workspace
Last updated 8/27/2013
Note: There is no way to determine the current position of a toolbar.
Arguments
toobar_id, position, relative_to
•
The toolbar
_id
argument is the ID of the toolbar, which is the value of the ID attribute on the toolbar tag in the
toolbars.xml file.
•
The position argument specifies where Dreamweaver positions the toolbar, relative to other toolbars. The possible
values for position are described in the following list:
•
top
is the default position. The toolbar appears at the top of the document window.
•
below
makes the toolbar appear at the beginning of the row immediately below the toolbar that relative
_to
specifies. Dreamweaver reports an error if the toolbar does not find the toolbar that relative
_to
specifies.
•
floating
makes the toolbar float above the document. Dreamweaver automatically places the toolbar so it is
offset from other floating toolbars. On the Macintosh,
floating
is treated the same way as
top
.
•
relative
_to="toolbar_id"
is required if position specifies
below
. Otherwise, it is ignored. Specifies the ID of
the toolbar below which this toolbar should be positioned.
Returns
Nothing.
Example
The following example sets the position of myEditbar below the myPicturebar toolbar:
dom.setToolbarPosition("myEditbar", "below", "myPicturebar");
dom.setToolbarVisibility()
Availability
Dreamweaver MX.
Description
This function shows or hides the specified toolbar.
Arguments
toolbar_id, bShow
•
The toolbar
_id
argument is the ID of the toolbar, the value of the ID attribute on the toolbar tag in the toolbars.xml file.
•
The bShow argument is a Boolean value that indicates whether to show or hide the toolbar. If bshow is
true
,
dom.setToolbarVisibility()
makes the toolbar visible
.
If bShow is
false
,
dom.setToolbarVisibility()
makes the toolbar invisible.
Returns
Nothing.
Example
The following example checks to see if the toolbar myEditbar is visible in the document window; if it is not visible, it
sets myEditbar to be visible: