Функция DlgDirListComboBoxA (winuser.h)

  • Статья

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

Синтаксис

int DlgDirListComboBoxA(
  [in]      HWND  hDlg,
  [in, out] LPSTR lpPathSpec,
  [in]      int   nIDComboBox,
  [in]      int   nIDStaticPath,
  [in]      UINT  uFiletype
);

Параметры

[in] hDlg

Тип: HWND

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

[in, out] lpPathSpec

Тип: LPTSTR

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

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

Если строка содержит имя файла, имя файла должно содержать по крайней мере один подстановочный знак (? или ). Если строка не содержит имя файла, функция ведет себя так, как если бы в качестве имени файла был указан подстановочный знак звездочки (). Все имена в указанном каталоге, которые соответствуют имени файла и имеют атрибуты, заданные параметром uFiletype , добавляются в список, отображаемый в поле со списком.

[in] nIDComboBox

Тип: int

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

[in] nIDStaticPath

Тип: int

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

[in] uFiletype

Тип: UINT

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

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

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

Тип: int

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

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

Комментарии

Если lpPathSpec указывает каталог, DlgDirListComboBox перед заполнением поля со списком изменяет текущий каталог на указанный каталог. Текст статического элемента управления, определяемого параметром nIDStaticPath , имеет имя нового текущего каталога.

DlgDirListComboBox отправляет CB_RESETCONTENT и CB_DIR сообщения в поле со списком.

Microsoft Windows NT 4.0 и более поздних версий. Если uFiletype содержит флаг DDL_DIRECTORY, а lpPathSpec указывает каталог первого уровня, например C:\TEMP, поле со списком всегда будет содержать запись ".." для корневого каталога. Это верно, даже если корневой каталог содержит скрытые или системные атрибуты, а флаги DDL_HIDDEN и DDL_SYSTEM не указаны. Корневой каталог тома NTFS содержит скрытые системные атрибуты и .

Предупреждение системы безопасности: Неправильное использование этой функции может поставить под угрозу безопасность программы. Неправильное использование этой функции включает в себя наличие lpPathSpec , указывающего буфер, не доступный для записи, или буфер без завершения со значением NULL. Прежде чем продолжить, ознакомьтесь с разделом Вопросы безопасности: Элементы управления Microsoft Windows .

Microsoft Windows NT 4.0 и более поздних версий: в списке отображаются длинные имена файлов, если таковые есть.

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

Windows 95 или более поздней версии: DlgDirListComboBoxW поддерживается Microsoft Layer для Юникода. Для этого необходимо добавить определенные файлы в приложение, как описано в разделе Microsoft Layer for Unicode в Windows Me/98/95 Systems.

Примечание

Заголовок winuser.h определяет DlgDirListComboBox в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll

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

DlgDirList

DlgDirSelectComboBoxEx

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