| Allegro CL version 8.2 Moderately revised from 8.1. 8.1 version |
Arguments: &key prompt stream root dont-go-below-domain browse-include-files
Displays a dialog where the user can select an existing directory (also known as a folder).
The newer function ask-user-for-new-or-existing-directory has more options than this one and works the same on all platforms, and so may be a better choice in most cases. On the other hand, on the Windows platform this function will show the dialog that is provided by Microsoft, with its native look and feel. On GTK, this function simply calls ask-user-for-new-or-existing-directory.
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.
Note too that it is not possible to specify the initially-selected directory or which subdirectories are initially open in the hierarchy that is presented.
The arguments are:
nil
,
the prompt "Select a folder." is used.
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. nil
means to
include all available file systems. The final slash is optional when either a pathname or
namestring is passed.
nil
, directories on both the
local computer and networked computers are accessible. .
See also ask-user-for-existing-pathname and ask-user-for-new-pathname.
Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page has had moderate revisions compared to the 8.1 page.
Created 2016.6.21.
| Allegro CL version 8.2 Moderately revised from 8.1. 8.1 version |