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.
A list of images, in one-to-one correspondence with the items. Elements corresponding to toolbar-button items or toolbar-component items are ignored
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
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
An optional image-set object which can be used to specify images. See toolbar-button and image-set for more details.
The class
toolbar-component
inherits from choice, and hence has a list of
items
. Its behavior is broadly similar to
button-panel.
The items argument 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-pane, option-pane, and text-input-choice.
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.