1 CAPI Reference Entries

toolbar

Class

Summary

This class provides a pane containing toolbar buttons and panes.

Superclasses

collection simple-pane toolbar-object

Slots

dividerp

Ift, a divider line is drawn above the toolbar, to separate it from the menu bar. The default value isnil.

images

A list of images, in one-to-one correspondence with the items. Elements corresponding totoolbar-button items ortoolbar-component items are ignored.

callbacks

A list of callback functions, in one-to-one correspondence with the items. Elements corresponding totoolbar-button items ortoolbar-component items are ignored

tooltips

A list of tooltip strings, in one-to-one correspondence with the items. Elements corresponding totoolbar-button items ortoolbar-component items are ignored

button-width

The width of the toolbar buttons. The default is 24.

button-height

The height of the toolbar buttons. The default is 22.

image-width

The width of buttons in the toolbar. The default value is 16.

image-height

The height of buttons in the toolbar. The default value is 15.

default-image-set

An optional image setting object which can be used to specify images. Seetoolbar-button andimage-set for more details.

Description

The classtoolbar inherits fromcollection, and therefore has a list ofitems. It behaves in a similar manner topush-button-panel, which inherits fromchoice.

Theitems keyword may be used to specify a mixture oftoolbar-buttons andtoolbar-components, or it may contain arbitrary objects as items. The list may also contain CAPI panes, which will appear within the toolbar. This is typically used withtext-input-panes,option-panes, andtext-input-choices.

For items that are not toolbar buttons or toolbar components, a toolbar button is automatically created, using the appropriate elements of the images, callbacks and tooltips lists. If no image is specified, the item itself is used as the image. For more information on acceptable values for images, seetoolbar-button.

All toolbar buttons within the item list behave as push buttons. However, toolbar button components may be single-selection or multiple-selection. Seetoolbar-component for further details.