prompt-for-directory message &key if-does-not-exist pathname file-package-is-directory pane-args popup-args owner continuation use-file-dialog => result, successp
A pathname, or
Arguments to pass to the pane.
Arguments to pass to the confirmer.
An owner window.
A function or
A generalized boolean.
prompt-for-directory prompts the user for a directory pathname using a dialog box. Like all the prompters,
prompt-for-directory returns two values: the directory pathname and a flag indicating success. The
flag will be
nil if the dialog was cancelled, and
On Windows and Motif, if
:ok, a non-existent directory can be chosen. When set to
:prompt, if a non-existent directory is chosen, the user is prompted for whether the directory should be created. When set to
:error, the user cannot choose a non existent directory. The default value of
file-package-is-directory is handled as by prompt-for-file .
owner specifies an owner window for the dialog. See Dialogs: Prompting for Input for details.
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-directory. On Cocoa, passing
causes the dialog to be made as a window-modal sheet and
prompt-for-directory returns immediately, leaving the dialog on the screen. The with-dialog-results macro provides a convenient way to create a
On Windows, when
is true (the default) and the
"shell-objs" module has been loaded (not the default), then the directory prompter looks like the standard file prompters.
is ignored on other platforms.
The prompt itself is created by passing an appropriate pane to popup-confirmer. Arguments can be passed to the
make-instance of the pane and the call to popup-confirmer using
respectively. Currently, the pane used to create the file prompter is internal to the CAPI.
CAPI User Guide and Reference Manual (Macintosh version) - 3 Aug 2017