beautypg.com

Dom.settoolbarvisibility() – Adobe Dreamweaver API Reference CS5 User Manual

Page 181

background image

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: