DlgDirListComboBox

Функція DlgDirListComboBox автоматично вказаний розкривний список із переліку. Розгорнути список з іменами всіх файлів, дисків і підтеки, які відповідають указані атрибути та рядок шляху.

int DlgDirListComboBox ( HWND  hDlg, / / ручка діалогове вікно зі спискомLPTSTRlpPathSpec, / / вказівник на шлях або ім'я файлу рядокIntnIDComboBox, / / ідентифікатор зі спискомIntnIDStaticPath, / / ідентифікатор статичні контролюUINTuFiletype / / файлу атрибути для відображення);
 

Параметри

hDlg

Обробляти до діалогового вікна, яке містить поле зі списком.

lpPathSpec

Вказівник на рядок із нульовим такі форма:

[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