int Dir( UINT attr, LPCTSTR lpszWildCard );
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.
Parameters
attr
Can be any combination of the enum values described in CFile::GetStatus, 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 lpszWildCard specifies a directory. |
| 0x0020 | File has been archived. |
| 0x4000 | Include all drives that match the name specified by lpszWildCard. |
| 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. |
lpszWildCard
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.
Example
// The pointer to my list box.
extern CListBox* pmyListBox;
// Add all the files and directories in the windows directory.
TCHAR lpszWinPath[MAX_PATH], lpszOldPath[MAX_PATH];
::GetWindowsDirectory(lpszWinPath, MAX_PATH);
::GetCurrentDirectory(MAX_PATH, lpszOldPath);
::SetCurrentDirectory(lpszWinPath);
pmyListBox->ResetContent();
pmyListBox->Dir(DDL_READWRITE|DDL_DIRECTORY, _T("*.*"));
::SetCurrentDirectory(lpszOldPath);
CListBox Overview | Class Members | Hierarchy Chart
See Also CWnd::DlgDirList, LB_DIR, CFile::GetStatus