beautypg.com

Toolbar functions, Dom.getshowtoolbariconlabels(), Dom.gettoolbaridarray() – Adobe Dreamweaver API Reference CS5 User Manual

Page 177

background image

172

DREAMWEAVER API REFERENCE

Workspace

Last updated 8/27/2013

Toolbar functions

The following JavaScript functions let you get and set the visibility of toolbars and toolbar labels, obtain the labels of
toolbar items in the current window, position toolbars, and obtain toolbar IDs. For more information on creating or
modifying toolbars, see “Toolbars” in Extending Dreamweaver Help.

dom.getShowToolbarIconLabels()

Availability
Dreamweaver MX.

Description
This function determines whether labels for buttons are visible in the current document window. Dreamweaver always
shows labels for non-button controls, if the labels are defined.

Arguments
None.

Returns
A Boolean value:

true

if labels for buttons are visible in the current document window;

false

otherwise.

Example
The following example makes labels for buttons visible:

var dom = dw.getDocumentDom();

if (dom.getShowToolbarIconLabels() == false)
{

dom.setShowToolbarIconLabels(true);

}

dom.getToolbarIdArray()

Availability
Dreamweaver MX.

Description
This function returns an array of the IDs of all the toolbars in the application. You can use

dom.getToolbarIdArray()

to turn off all toolbars so you can reposition them and make only a specific set visible.

Arguments
None.

Returns
An array of all toolbar IDs.

Example
The following example stores the array of toolbar IDs in the

tb_ids

variable: