DlgDirListComboBox

DlgDirListComboBox функция заполняет указанный списком с список каталогов. Он заполняет список с именами всех файлов, дисков и подкаталогов, которые совпадают с заданными атрибутами и строки пути.

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

Параметры

hDlg

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

lpPathSpec

Указатель на ограниченную значением null строку следующего вида:

[drive:][\]][каталог\[...]][имя файла]

Если указанная строка содержит диск или путь к каталогу, DlgDirListComboBox функция изменяет текущий диск и каталог перед заполнением списка. После заполнения списка на диск и каталог, путь, удаляются из строки, указанной в параметре lpPathSpec.

nIDComboBox

Задает идентификатор элемента управления поле со списком в диалоговом окне. Если nIDComboBox равен нулю, функция DlgDirListComboBox предполагается не списком и не пытается заполнить ее.

nIDStaticPath

Задает идентификатор элемента управления статический текст, в котором функция DlgDirListComboBox является отображение текущего каталога. Если nIDStaticPath равен нулю, DlgDirListComboBox предполагает, что такой контроль присутствует.

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.

Примечания

Если параметр lpszPathSpec указывает строку нулевой длины или строку, задающую диска, каталога или оба, но не имя файла — имя файла *. * (символы), предполагается.

Windows NT:

Список каталогов отображает длинные имена, если таковые имеются.

Windows 95:

Список каталогов отображает коротких имен файлов (8.3 форма). Можно использовать функции SHGetFileInfo или GetFullPathName для получения соответствующего долго имя файла.

QuickInfo

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

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

Обзор полей со списком, списком функций, DlgDirList, DlgDirSelectComboBoxEx, GetFullPathName, SHGetFileInfo

Index