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
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
.