A function that is called when the toolbar button is pressed.
A slot specifying the image to use for the toolbar button.
An optional string which is displayed when the mouse moves over the button.
Toolbar buttons may be placed within toolbars and toolbar components. However, there is usually no need to create toolbar buttons explicitly; instead, the :callbacks
, :images
and :tooltips
arguments to toolbar
or toolbar-component
can be used.
The image
may be one of the following:
This specifies the filename of a file suitable for loading with gp:load-image
. Currently this must be a bitmap file.
The symbol must have been previously registered by means of a call to gp:register-image-translation
.
An image object, as returned by gp: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 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.
The image should be of the correct size for the toolbar. By default, this is 16 pixels wide and 15 pixels high.