LB_DIR сообщение
Добавляет имена в список, отображаемый полем со списком. Сообщение добавляет имена каталогов и файлов, которые соответствуют указанной строке и набору атрибутов файла. LB_DIR также можно добавить сопоставленные буквы дисков в список.
Параметры
-
wParam
-
Атрибуты файлов или каталогов, добавляемых в список. Этот параметр может быть одним или несколькими из следующих значений.
Значение Значение - DDL_ARCHIVE
Включает архивные файлы. - DDL_DIRECTORY
Включает подкаталоги. Имена подкаталогов заключаются в квадратные скобки ([ ]). - DDL_DRIVES
Все сопоставленные диски добавляются в список. Диски перечислены в формате [-x-], где x — буква диска. - DDL_EXCLUSIVE
Включает только файлы с указанными атрибутами. По умолчанию файлы для чтения и записи отображаются, даже если DDL_READWRITE не указан. - DDL_HIDDEN
Включает скрытые файлы. - DDL_READONLY
Включает файлы, доступные только для чтения. - DDL_READWRITE
Включает файлы для чтения и записи без дополнительных атрибутов. Это параметр по умолчанию. - DDL_SYSTEM
Включает системные файлы. -
lParam
-
Указатель на строку, завершающуюся null, которая указывает абсолютный путь, относительный путь или имя файла. Абсолютный путь может начинаться с буквы диска (например, d:). или UNC-имя (например, \\ имя_\ компьютера).
Если строка указывает имя файла или каталог с атрибутами, заданными параметром wParam , имя файла или каталог добавляется в список. Если имя файла или имя каталога содержит подстановочные знаки (? или *), все файлы или каталоги, которые соответствуют выражению с подстановочными знаками и имеют атрибуты, заданные параметром wParam , добавляются в список.
Возвращаемое значение
Если сообщение завершается успешно, возвращаемым значением является отсчитываемый от нуля индекс фамилии, добавленной в список.
При возникновении ошибки возвращаемое значение будет LB_ERR. Если места недостаточно для хранения новых строк, возвращаемое значение LB_ERRSPACE.
Комментарии
Сообщение LB_INITSTORAGE помогает ускорить инициализацию списков с большим количеством элементов (более 100). Он резервирует указанный объем памяти, чтобы последующие LB_DIR сообщения занимают самое короткое время. Вы можете использовать оценки для параметров wParam и lParam . Если вы переоцените, выделяется дополнительная память; если вы недооцениваете, обычное выделение используется для элементов, превышающих запрошенную сумму.
Если wParam содержит флаг DDL_DIRECTORY, а lParam указывает все подкаталоги каталога первого уровня, например C:\TEMP\*, в поле списка всегда будет содержаться запись ".." для корневого каталога. Это верно, даже если корневой каталог содержит скрытые или системные атрибуты, а флаги DDL_HIDDEN и DDL_SYSTEM не указаны. Корневой каталог тома NTFS содержит скрытые и системные атрибуты.
В списке отображаются длинные имена файлов, если таковые есть.
Для приложения ANSI система преобразует текст в списке в Юникод с помощью CP_ACP. Это может привести к проблемам. Например, римские символы с акцентами в списке, отличном от Юникода в японском Windows, будут искажены. Чтобы устранить эту проблему, скомпилируйте приложение как Юникод или используйте список, нарисованный владельцем.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2003 [только классические приложения] |
| Заголовок |
|