Arguments: &key prompt stream root dont-go-below-domain browse-include-files
Displays a dialog showing directories. The chosen directory is returned as a pathname object. Note that the pathname of the directory is stored in a buffer and if the buffer is too small, an error will be signaled. The buffer size is determined by file-selection-buffer-size. The default size is large enough to hold at least 12 pathnames so this should not be a problem for this function, which returns one pathname only.
The arguments are:
nil, indicating the directory that will appear as the root node in the dialog's directory tree. Only this directory and its subdirectory descendents will be presented for selection by the end user.
nilmeans to include all available file systems. Note that if a namestring is passed, backslashes must be used rather than forward slashes. The final slash is optional when either a pathname or namstring is passed.
See also ask-user-for-existing-pathname and ask-user-for-new-pathname.
Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.
The documentation is described in introduction.htm and the index is in index.htm.
Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.