NextPrevUpTopContentsIndex

toolbar

Class
Summary

This class provides a pane containing toolbar buttons and panes.

Package

capi

Superclasses

collection
simple-pane
titled-object
toolbar-object

Initargs

:dividerp

If t , a divider line is drawn above the toolbar, to separate it from the menu bar. The default value is nil .

: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

:button-width

The width of the toolbar buttons.

:button-height

The height of the toolbar buttons.

:image-width

The width of images in the toolbar. .

:image-height

The height of images in the toolbar.

: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 inherits from collection, and therefore has a list of items . It behaves in a similar manner to push-button-panel, which inherits from choice.

The items argument may be used to specify a mixture of toolbar-buttons and toolbar-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 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.

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

images , if supplied, must specify images all of the same size.

image-width and image-height must match the sub-image dimensions in default-image-set or the dimensions of the images .

See also

collection
image-set
push-button-panel
toolbar-component


LispWorks CAPI Reference Manual - 11 Apr 2005

NextPrevUpTopContentsIndex