A function that is called when the user presses the toolbar button and popup-interface is non-nil.
Specifies the image to use for the toolbar button.
An optional string which is displayed, on Microsoft Windows, when the mouse moves over the button.
:tooltip is deprecated.
An object used for lookup of help. Default value
Links the button to a menu item.
A menu or
An interface or
Toolbar buttons may be placed within toolbars and toolbar components. However, there is usually no need to create toolbar buttons explicitly; instead, the
arguments to toolbar or toolbar-component can be used. To add tooltips, use the interface
This specifies the filename of a file suitable for loading with load-image. Currently this must be a bitmap file.
The symbol must either have been previously registered by means of a call to register-image-translation, or be one of the following symbols, which map to standard images:
On Microsoft Windows, the following symbols are also recognized for view images:
An image object, as returned by load-image.
This allows a single bitmap to be created which contains several button images side by side. See make-image-locator for more information. On Microsoft Windows, this also allows access to bitmaps stored as resources in a DLL.
This is a zero-based index into the default-image-set of the toolbar or toolbar component in which the toolbar button is used.
help-key is interpreted as described for element.
, if non-nil, should match the
of a menu-item in the same interface as the button. Then, the action of pressing the button is remapped to selecting that menu-item and calling its
. The default value of
If dropdown-menu is non-nil then it should be a menu object to display for the button.
is non-nil then it should be a function which will be called with the
toolbar-button as its single argument. It should return a menu object to display for the button.
There is a separate smaller button for the dropdown menu next to the main button.
There is no main button, only the smaller button for the dropdown.
There is only one button and the menu is displayed when the user holds the mouse down over the button for some short delay. If the user clicks on the button then the normal callback is called.
Note: dropdown-menu-kind is not supported for toolbar buttons in the interface toolbar-items list.
, if non-nil, should be an interface. When the user clicks on the toolbar button, the interface
is displayed near to the button. The normal
is not called, but you can detect when the interface appears by using its
is useful for popping up windows with more complex interaction than a menu can provide. The default value of
Note: popup-interface is not supported for toolbar buttons in the interface toolbar-items list.
Toolbar buttons can display text, which should be in the data or text slot inherited from item.
(capi:display (make-instance 'redo))
CAPI User Guide and Reference Manual (Macintosh version) - 3 Aug 2017