DlgDirList

Функція DlgDirList заповнює указаний список з іменами всіх файлів, які відповідають вказаний шлях або ім'я файлу.

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

Параметри

hDlg

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

lpPathSpec

Курсор в рядок з нульовим, що містить шлях або ім'я файлу. 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.

Дивіться також

Огляд списку полів, функцій списку поля, DlgDirListComboBox, DlgDirSelectComboBoxEx, DlgDirSelectEx

Index