Class

Summary

A toolbar component is used to group several toolbar buttons together. Each component is separated from the surrounding components and buttons.

Toolbar components are choices, and may be used to implement toolbars on which groups of button have single-selection or multiple-selection functionality.

Superclasses

toolbar-object
choice

Slots

images

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

callbacks

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

tooltips

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

default-image-set

An optional image-set object which can be used to specify images. See toolbar-button and image-set for more details.

Description

The class toolbar-component inherits from choice, and hence has a list of items. Its behavior is broadly similar to button-panel .

The :items keyword may be used to specify a mixture of toolbar buttons and toolbar components, or may contain arbitrary objects as items. The list may also contain CAPI panes, which will appear within the toolbar. This is typically used with text-input-panes , option-panes , and text-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, see toolbar-button .

See also

toolbar
toolbar-button