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.
No more than one of
should be non-nil. Each defaults to
. If one of these is non-nil, it should be a function which is called before the
is displayed and when update-toolbar is called and which determines which items are selected. The function takes a single argument, which is the interface of the
, if non-nil, should return a list of indices suitable for passing to the choice accessor
, if non-nil, should return an object which is an item in the
, or is equal to such an item when compared by the
CAPI Reference Manual - 15 Dec 2011