CListBox::Dir

Syntax

int Dir( UINT attr, const char FAR* lpWildCard );

Parameters

attr

Can be any combination of the CFile::GetStatus enum flags, or any combination of the following values:

Value

Meaning

0x0000	File can be read from or written to.
0x0001	File can be read from, but not written to.
0x0002	File is hidden and does not appear in a directory listing.
0x0004	File is a system file.
0x0010	The name specified by lpWildCard specifies a directory.
0x0020	File has been archived.
0x4000	Include all drives that match the name specified by lpWildCard.
0x8000	Exclusive flag. If the exclusive flag is set, only files of the specified type are listed. Otherwise, files of the specified type are listed in addition to “normal” files.

lpWildCard

Points to a file-specification string. The string can contain wildcards (for example, *.*).

Remarks

Adds a list of filenames and/or drives to a list box.

Return Value

The zero-based index of the last filename added to the list. The return value is LB_ERR if an error occurs; the return value is LB_ERRSPACE if insufficient space is available to store the new strings.