Home > Element Reference : Toolbox

Contents

### Toolbox

A container for toolbars. It is a type of box but defaults to vertical orientation. If a toolbar is placed inside a toolbox, a grippy is displayed on its left or upper edge. The user may click the grippy to collapse the toolbar. If multiple toolbars are placed in the same toolbox, they will all collapse into the same row. The Firefox browser does not have grippies so toolbars cannot be collapsed and expanded.

More information about toolbox

The toolbox element implements the following interfaces:

nsIAccessibleProvider

Properties and Methods:

accessible | appendCustomToolbar | collapseToolbar | customToolbarCount | expandToolbar
palette | toolbarset

#### Attributes:

Inherited from XUL Element:

align | allowevents | allownegativeassertions | class | coalesceduplicatearcs
collapsed | container | containment | context | contextmenu
datasources | dir | empty | equalsize | flags
flex | height | hidden | id | insertafter
insertbefore | left | maxheight | maxwidth | menu
minheight | minwidth | mousethrough | observes | ordinal
orient | pack | persist | popup | position
preference-editable | ref | removeelement | sortDirection | sortResource
sortResource2 | statustext | style | template | tooltip
tooltiptext | top | uri | wait-cursor | width

#### Properties and Methods:

Inherited from XUL Element:

align
allowEvents
blur
boxObject
boxObject.element
boxObject.getLookAndFeelMetric
boxObject.height
boxObject.screenX
boxObject.screenY
boxObject.width
boxObject.x
boxObject.y
builder
className
click
collapsed
contextMenu
controllers
database
datasources
dir
doCommand
flex
focus
getElementsByAttribute
height
hidden
id
left
maxHeight
maxWidth
menu
minHeight
minWidth
observes
ordinal
orient
pack
persist
ref
resource
statusText
style
tooltip
tooltipText
top
width

Inherited from Element:

addEventListener
appendChild
attributes
childNodes
cloneNode
dispatchEvent
firstChild
getAttribute
getAttributeNS
getAttributeNode
getAttributeNodeNS
getElementsByTagName
getElementsByTagNameNS
hasAttribute
hasAttributeNS
hasAttributes
hasChildNodes
insertBefore
isSupported
lastChild
localName
namespaceURI
nextSibling
nodeName
nodeType
nodeValue
normalize
ownerDocument
parentNode
prefix
previousSibling
removeAttribute
removeAttributeNS
removeAttributeNode
removeChild
removeEventListener
replaceChild
setAttribute
setAttributeNS
setAttributeNode
setAttributeNodeNS
tagName

##### accessible

Type: nsIAccessible

Returns the accessibility object for the toolbox.

##### appendCustomToolbar ( name , currentset ) Firefox only

Adds a custom toolbar to the toolbox with the given name. You can supply a comma-separated list of toolbar item ids as the second argument to add some items by default.

##### collapseToolbar ( toolbar ) Not in Firefox

Return Type: no return value

Collapse the given toolbar which should be contained in the toolbox.

##### customToolbarCount Firefox only

The number of custom toolbars currently within the toolbox.

##### expandToolbar ( toolbar ) Not in Firefox

Return Type: no return value

Expand the given toolbar which should be contained in the toolbox.

##### palette Firefox only

The toolbarpalette within the toolbox.

##### toolbarset Firefox only

The toolbarset within the toolbox.

Copyright (C) 1999 - 2004 XulPlanet.com