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

NextPrevUpTopContentsIndex

prompt-for-forms

Function
Summary

Displays a text input pane prompting the user for a number of forms.

Package

capi

Signature

prompt-for-forms message &key package initial-value value-function pane-args popup-args continuation => result , okp

Description

The function prompt-for-forms prompts the user for a number of forms by providing a text input pane that the forms can be typed into, and it returns the forms in a list. The forms are read in the specified package or *package* if not. If evaluate is non-nil then the result is the evaluation of the form, else it is just the form itself.

The printed version of initial-value will be placed into the text input pane as a default.

If continuation is non-nil, then it must be a function with a lambda list that accepts two arguments. The continuation function is called with the values that would normally be returned by prompt-for-forms. On Cocoa, passing continuation causes the dialog to be made as a window-modal sheet and prompt-for-forms returns immediately, leaving the dialog on the screen. The with-dialog-results macro provides a convenient way to create a continuation function.

The prompter is created by passing an appropriate pane (in this case a text input pane) to popup-confirmer. Arguments can be passed to the make-instance of the pane and the call to popup-confirmer using pane-args and popup-args respectively.

Example

Try the following example, and enter 1 2 3 into the input pane.

(capi:prompt-for-forms "Enter some forms:")
See also

prompt-for-form
prompt-for-string
popup-confirmer
text-input-pane


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

NextPrevUpTopContentsIndex