prompt-for-string prompts the user for a string and returns that string in
and a flag
indicating that the dialog was not cancelled. The initial string can either be supplied directly as a string using the
argument, or by passing
for that value.
princ-to-string. The value returned can be converted into a different value by passing a
, which by default is the identity function. This
gets passed the text that was entered into the pane, and should return both the value to return and a flag that should be non-nil if the value that was entered is not acceptable. If an
is passed, then it should return non-nil if the value about to be returned is acceptable.
prompt-for-string creates an instance of text-input-pane or text-input-choice depending on the value of
. Arguments can be passed to the
make-instance of this pane using
prompt-for-string then passes this pane to popup-confirmer. Arguments can be passed to the call to popup-confirmer using
history-function is called with no argument to obtain the history which is used as the items of the text-input-choice, and with the latest input to update the history.
is non-nil, then it must be a function with a lambda list that accepts two arguments. The
function is called with the values that would normally be returned by
prompt-for-string. On Cocoa, passing
causes the dialog to be made as a window-modal sheet and
prompt-for-string returns immediately, leaving the dialog on the screen. The with-dialog-results macro provides a convenient way to create a
(capi:prompt-for-string "Enter a string:")
CAPI User Guide and Reference Manual (Macintosh version) - 25 Feb 2015