сообщение CB_DIR

  • Статья

Добавляет имена в список, отображаемый полем со списком. Сообщение добавляет имена каталогов и файлов, которые соответствуют указанной строке и набору атрибутов файла. CB_DIR также можно добавить сопоставленные буквы дисков в список.

Параметры

wParam

Атрибуты файлов или каталогов, добавляемых в поле со списком. Этот параметр может быть одним или несколькими из следующих значений.

Значение Значение
DDL_ARCHIVE
 Включает архивные файлы.
DDL_DIRECTORY
 Включает подкаталоги, заключенные в квадратные скобки ([ ]).
DDL_DRIVES
 Все сопоставленные диски добавляются в список. Диски перечислены в формате [-x-], где x — буква диска.
DDL_EXCLUSIVE
 Включает только файлы с указанными атрибутами. По умолчанию файлы для чтения и записи отображаются, даже если DDL_READWRITE не указан.
DDL_HIDDEN
 Включает скрытые файлы.
DDL_READONLY
 Включает файлы, доступные только для чтения.
DDL_READWRITE
 Включает файлы для чтения и записи без дополнительных атрибутов. Это значение по умолчанию.
DDL_SYSTEM
 Включает системные файлы.

lParam

Указатель LPCTSTR на строку со значением NULL, которая указывает абсолютный путь, относительный путь или имя файла. Абсолютный путь может начинаться с буквы диска (например, d:). или UNC-имя (например, \\machinename\sharename). Если строка указывает имя файла или каталог с атрибутами, заданными параметром wParam , имя файла или каталог добавляется в список. Если имя файла или имя каталога содержит подстановочные знаки (? или *), все файлы или каталоги, которые соответствуют выражению с подстановочными знаками и имеют атрибуты, заданные параметром wParam , добавляются в список, отображаемый в поле со списком.

Возвращаемое значение

Если сообщение завершается успешно, возвращаемым значением является отсчитываемый от нуля индекс фамилии, добавленной в список.

Если возникает ошибка, возвращаемое значение будет CB_ERR. Если места недостаточно для хранения новых строк, возвращаемое значение CB_ERRSPACE.

Комментарии

Если wParam содержит флаг DDL_DIRECTORY, а lParam указывает все подкаталоги каталога первого уровня, например C:\TEMP\*, в поле списка всегда будет содержаться запись ".." для корневого каталога. Это верно, даже если корневой каталог содержит скрытые или системные атрибуты, а флаги DDL_HIDDEN и DDL_SYSTEM не указаны. Корневой каталог тома NTFS содержит скрытые и системные атрибуты.

В списке отображаются длинные имена файлов, если таковые есть.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Заголовок
Winuser.h (включая Windows.h)

См. также раздел

Справочные материалы

CB_ADDSTRING

CB_INSERTSTRING

DlgDirListComboBox