Non-nil if the option pane is enabled.
A plist of keywords and image-list objects.
option-pane inherits from choice, and so has all of the standard choice behavior such as selection and callbacks. It also has an extra
slot along with an accessor which is used to enable and disable the option pane.
is implemented only on Microsoft Windows. If
is an integer then the popup menu is no longer than this, and is scrollable if there are more items. If
:default, then the popup menu is no longer than 10. This is the default value.
is non-nil, it should be a function of one argument that will be called just before the popup menu appears when the user clicks on it. The single argument to the function is the option pane and the return value is ignored. If required, the function can change the items or selection of the pane. The default value of
is non-nil, it should be a function of one argument which is called with each item. The return value depends on
contains an image-list for the
:normal key, then the result of
should be one of the following:
This specifies the filename of a file suitable for loading with load-image. Currently this must be a bitmap file.
The symbol must have been previously registered by means of a call to register-image-translation.
An image object, as returned by load-image.
This allowing a single bitmap to be created which contains several button images side by side. See make-image-locator for more information. On Microsoft Windows, it also allows access to bitmaps stored as resources in a DLL.
Otherwise if there is no image-list then it should return one of:
No image is shown.
An image object
An image id or an external-image object
The system converts the value to a temporary image for the item and frees it when it is no longer needed.
is specified, it should be a plist containing the keyword
:normal as a key. The corresponding value should be an image-list object. No other keys are supported at the present time. The image-list associated with the
:normal key is used with the
(see above) to specify an image to display in each tab.
should be an item (compared using
) that acts as a separator between other items. A separator item is not selectable. The default value
nil means that there are no separators (regardless of
On Microsoft Windows, if
contains the keyword
:simple-text-only, then the
option-pane is displayed using the UI theme and the
initargs are not supported. Otherwise it is displayed without the UI theme and those options work as documented. This is a limitation in Microsoft Windows.
option-pane. For an element with similar functionality which allows editing, see text-input-choice.
:image-lists are currently only implemented for Microsoft Windows, GTK+ and Cocoa.
There are further examples in Self-contained examples.
CAPI User Guide and Reference Manual (Windows version) - 25 Feb 2015