Next Prev Up Top Contents Index

prompt-for-directory

Function
Summary

The function prompt-for-directory displays a dialog prompting the user for a directory.

Syntax
prompt-for-directory message &key if-does-not-exist pathname ok-check pane-args popup-args owner
Description

The function prompt-for-directory prompts the user for a directory pathname using a dialog box. The initial directory is pathname . Like all the prompters, prompt-for-directory returns two values: the directory pathname and a flag indicating success. The success flag will be nil if the dialog was cancelled, and t otherwise. An ok-check function can be specified, which should return non- nil if a given pathname is valid.

if-does-not-exist is one of :ok , :prompt or :error . When set to :ok , a nonexistent 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 is :prompt .

owner is a capi top-level interface which becomes the owner of the dialog. In a CAPI callback, this defaults to the current interface. Otherwise an interface is chosen for the current thread.

Finally, as with all of the prompting functions, 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 pane-args and popup-args respectively. Currently, the pane used to create the file prompter is internal to the CAPI.

See also

popup-confirmer
prompt-for-file


LispWorks CAPI Reference Manual - 14 Dec 2001

Next Prev Up Top Contents Index