All Manuals > CAPI User Guide and Reference Manual > 21 CAPI Reference Entries

NextPrevUpTopContentsIndex

text-input-choice

Class
Summary

This pane consists of a text input area, and a button. Clicking on the button displays a list of editable strings, and selecting one of the strings automatically pastes it into the text input area.

Package

capi

Superclasses

choice
text-input-pane

Initargs

:visible-items-count

An integer specifying the maximum length of the list, or the symbol :default.

:popup-callback

A function called just before the list appears, or nil.

Description

The class text-input-choice behaves in the same way as a text-input-pane, but has additional functionality. The element inherits from choice, and the choice items are used as the items to display when the user clicks on the button.

The callback is called when the user presses the Return key.

The selection-callback is called when the user selects an item in the list.

Notes

The user can edit the items in a text-input-choice. For an element with similar functionality which does not allow editing, see option-pane.

Compatibility note

In LispWorks 6.0 and earlier versions the text-input-pane initarg value enabled :read-only is not supported for text-input-choice on Microsoft Windows. This restriction is removed for LispWorks 6.1 and later versions.

Examples
(example-edit-file "capi/elements/text-input-choice")
See also

choice
option-pane
text-input-pane
Choices - panes with items
Toolbar items other than buttons with images


CAPI User Guide and Reference Manual (Macintosh version) - 3 Aug 2017

NextPrevUpTopContentsIndex