files-to-list-box

Function

Package: common-graphics

Arguments: list-box directory-string &key static-text read-write-p read-only-p hidden-p system-p archive-p directory-p drive-p current-directory-p

This is the general function to display contents of a directory in a list-box control. The two required arguments are a list-box in which to display the directory contents, and a string naming the directory to display. The directory-string can be either a complete pathname namestring with * & ? wildcard characters, or a directory namestring either ending in a backslash or not. It should not be a complete namestring of a single file with no wildcard characters.

If a static-text widget is passed for the :static-text keyword argument, then the directory name itself will be displayed in that (second) widget.

Each of the other keyword arguments determines whether that type of file (or subdirectory) should be included in the list. So by default ordinary read-write files are the only type included. :directory-p means to include subdirectories of the named directory; :drive-p means to include drive letters for each disk drive on the machine other than the drive of the named directory; :current-directory-p means to include a [.] entry for the named directory itself.

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.

Created 2000.10.5.