Функція DlgDirList заповнює указаний список з іменами всіх файлів, які відповідають вказаний шлях або ім'я файлу.
int DlgDirList ( HWND hDlg, / / ручка діалогове вікно зі спискомLPTSTRlpPathSpec, / / вказівник на шлях або ім'я файлу рядокIntnIDListBox, / / ідентифікатор спискуIntnIDStaticPath, / / ідентифікатор статичні контролюUINTuFileType / / файлу атрибути для відображення);
Значення | Опис |
---|---|
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 до списку.
nbsp; Windows &NT: вимагає 3.1 або пізнішої версії.
Windows:Вимагає Windows 95 або пізнішої версії.
Windows CE:Не підтримується.
Заголовка:Оголошена в winuser.h.
Імпортувати бібліотеки:Використання user32.lib.
Юнікод:Реалізований у вигляді Юнікод і ANSI версії на Windows NT.
Огляд списку полів, функцій списку поля, DlgDirListComboBox, DlgDirSelectComboBoxEx, DlgDirSelectEx