int DlgDirList( LPTSTR lpPathSpec, int nIDListBox, int nIDStaticPath, UINT nFileType );
Возвращаемое значение
Отлично от нуля если функция успешна, иначе 0.
Параметры
lpPathSpec
Указатель на строку с нулевым символом в конце, которая содержит путь или имя файла. DlgDirList изменяет эту строку которая должна быть достаточно длинны чтобы содержать модификации.
nIDListBox
Определяет идентификатор списка. Если nIDListBox - 0, DlgDirList принимает что списка не существует и не пытается заполнять его.
nIDStaticPath
Определяет идентификатор статического текстового элемента управления, используемого, чтобы отобразить текущий диск и каталог. Если nIDStaticPath - 0, DlgDirList принимает, что такого текстового элемента управление не присутствует.
nFileType
Определяет атрибуты файлов, которые нужно отобразить. Это может быть любая комбинация следующих значений:
- DDL_READWRITE - Файлы данных чтения-записи без дополнительных атрибутов.
- DDL_READONLY - Файлы только для чтения.
- DDL_HIDDEN - Невидимые файлы.
- DDL_SYSTEM - Системные файлы.
- DDL_DIRECTORY - Каталоги.
- DDL_ARCHIVE - Архивные файлы.
- DDL_POSTMSGS - LB_DIR флажок. Если флажок LB_DIR установлен Windows помещает сообщения, сгенерированные DlgDirList в очереди прикладной программы иначе, они посланы непосредственно процедуре диалогового окна.
- DDL_DRIVES - Диски. Если флажок DDL_DRIVES установлен, флажок DDL_EXCLUSIVE установлен автоматически. Следовательно, чтобы создать список каталога который включает диски и файлы Вы должен вызвать DlgDirList дважды один раз с DDL_DRIVES для дисков и один раз с флажками для остальной части списка.
- DDL_EXCLUSIVE - Исключительный бит. Если исключительный бит установлен, только файлы определенного типа перечислены, иначе все файлы перечислены.
Заполняет список именами каталогов или файлов. DlgDirList посылает LB_RESETCONTENT и LB_DIR сообщения к списку. Он заполняет список, определенный nIDListBox с именами всех файлов, которые соответствуют пути, данному lpPathSpec. LpPathSpec параметр имеет следующую форму:
[drive:] [ [\u]directory[\idirectory]...\u] [filename]
В этом примере, диск - имя диска, каталог - допустимое имя каталога, и имя файла - допустимое имя файла, которое должно содержать по крайней мере одни подстановочные знаки. Вопросительный знак (?), что означает соответствие любой символ, и звездочка (*), означая соответствие любое число символов. Если Вы определяете строку с 0 длинами для lpPathSpec, или если Вы определяете только каталог, но не включают никакую спецификацию файла, строка будет изменена на "*.*".
Если lpPathSpec включает диск и имя каталога, текущий диск и каталог изменены на обозначенный диск и каталог прежде, чем список заполнен. Текстовый элемент управление, идентифицированное nIDStaticPath также модифицируется с новым диском или именем каталога. После того, как список заполнен, lpPathSpec модифицируется, удаляя диск или часть пути каталога.
Пример
// Если pDialog указывает на объект CDialog со списком
// c идентификатором IDC_DIRLIST, это обращение заполнит
// блок только не скрытыми подкаталогами в корне
// диска C:\.
pDialog->DlgDirList(_T("C:\\"), IDC_DIRLIST, 0, DDL_EXCLUSIVE | DDL_DIRECTORY);
