All Manuals > CAPI Reference Manual > 1 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 drop-down list of 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 drop-down list, or the symbol :default .

:popup-callback

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

Description

The text-input-choice class 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 using the drop-down list.

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

See examples/capi/elements/text-input-choice.lisp .

See also

choice
text-input-pane


CAPI Reference Manual - 15 Dec 2011

NextPrevUpTopContentsIndex