DlgDirList

DlgDirList функция заполняет указанный список с именами всех файлов, соответствующих указанному пути или имени файла.

int () DlgDirList HWND  hDlg, / / обработать диалоговое окно со спискомLPTSTRlpPathSpec, / / указатель пути или имени файла строкуintnIDListBox, / / идентификатор спискаintnIDStaticPath, / / идентификатор статический элемент управленияUINTuFileType / / файл атрибуты для отображения);
 

Параметры

hDlg

Дескриптор диалогового окна поле, содержащее поле списка.

lpPathSpec

Указатель на ограниченную значением null строку, содержащую путь или имя файла. DlgDirList изменяет эту строку, которая должна быть достаточно долго, чтобы содержать изменения. Для получения дополнительных сведений об этом параметре в разделе Примечания.

nIDListBox

Указывает идентификатор списка. Если этот параметр равен нулю, DlgDirList предполагает, что окно не список существует и не пытается заполнить один.

nIDStaticPath

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

uFileType

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

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

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

Если функция выполнена успешно, возвращаемое значение не равно нулю.

Если вызов функции был неуспешен, возвращаемое значение равно нулю. Например если строка, указанная в lpPathSpec не является допустимым путем, операция не выполняется. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Примечания

Если вы укажите строку нулевой длины для параметра lpPathSpec или если указывается только имя папки без имени файла, строка будет изменено на *. *

Параметр lpPathSpec имеет следующий вид:

[диск:] [[\u]каталог[\iкаталог] \u] [имя файла]

В этом примере диск — это буква диска, в каталог — это правильное имя папки и имя файла является допустимое имя файла, который должен содержать по крайней мере один символ (? и *).

Если lpPathSpec включает в себя диск и/или имя каталога, текущий диск и каталог изменяются на указанный диск и каталог, прежде чем заполнить поле со списком. Статический элемент управления, определенного параметром nIDStaticPath также обновляется с нового диска, имя каталога или оба.

После заполнения поле со списком DlgDirList обновляет lpPathSpec , удалив диск или каталог часть или оба, пути и имени файла.

DlgDirList посылает сообщения LB_RESETCONTENT и LB_DIR в список.

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Не поддерживается.
Заголовок:Объявленные в winuser.h.
Импорта библиотеки:Используйте user32.lib.
Юникод:В версии Юникода и ANSI в Windows NT.

Родственные слова

Обзор полей списка, списка функций Box, DlgDirListComboBox, DlgDirSelectComboBoxEx, DlgDirSelectEx

Index