CW&nd::DlgDirListnbsp;

Int DlgDirList ( LPTSTR lpPathSpec, int nIDListBox, int nIDStaticPath, UINT nFileType );

Значення, яке повертається

Ненульовий, якщо функція успішно; в іншому випадку 0.

Параметри

lpPathSpec

Пункту до нульовим закінченням, що містить шлях або ім'я файлу. DlgDirList змінює рядок, яка повинна бути досить довго, щоб містити зміни. Докладніше перегляньте наступний розділ «Зауваження».

nIDListBox

Визначає ідентифікатор списку. Якщо nIDListBox 0, DlgDirList припускає, що немає списку існує і не намагатися заповнити одну.

nIDStaticPath

Визначає ідентифікатор керування статичного тексту, який використовується для відображення поточного диска та каталогів. Якщо nIDStaticPath 0, DlgDirList припускає, що немає такого контролю текст присутня.

nFileType

Визначає атрибути файлів для відображення. Це може бути будь-яка комбінація таких значень:

• DDL_READWRITE   Читання і запис даних файлів з не додаткових атрибутів.
  
  
• DDL_READO&NLYnbsp;  Файли лише для читання.
  
  
• DDL_HIDDE&Nnbsp;  Приховані файли.
  
  
• DDL_SYSTEM   Системні файли.
  
  
• DDL_DIRECTORY   Каталоги.
  
  
• DDL_ARCHIVE   Архіви.
  
  
• DDL_POSTMSGS   Прапор LB_DIR . Якщо LB_DIR прапор, Windows переміщує повідомлення, що генеруються DlgDirList у черзі програми; в іншому випадку, вони надсилаються безпосередньо в діалоговому вікні порядок.
  
  
• DDL_DRIVES   Диски. Якщо DDL_DRIVES прапор, DDL_EXCLUSIVE прапор встановлюється автоматично. Таким чином, для створення списку файлів каталогу, який включає диски і файли, ви повинні викликати DlgDirList двічі: один раз з DDL_DRIVES прапор набір і один раз з прапорів для решти списку.
  
  
• DDL_EXCLUSIVE   Ексклюзивні біт. Якщо встановлюється ексклюзивні біт, тільки файлів указаного типу списку; в іншому випадку перераховані нормальний файлів і файлів указаного типу.

Зауваження

Заповнює списку із файлу або каталогу лістингу. Надсилає DlgDirList LB_RESETCONTENT і LB_DIR повідомлень до списку. Вона заповнює списку визначених nIDListBox з іменами всіх файлів, які відповідають шлях, з огляду на lpPathSpec.

LpPathSpec параметр має такий вигляд:

[диска:] [[\u]Каталог[\iКаталог]... \u] [ім'я файлу]

У цьому прикладі диск — буква диска, Каталог є дійсним каталогу ім'я та ім'я файлу є припустиме ім'я файлу, який має містити принаймні один узагальнення. На знаки підстановки є знак запитання (?), що означає, що відповідають будь-який символ і зірочку (*), що означає, що замість будь-якої кількості знаків.

Якщо ви вказуєте 0-довжина рядка для lpPathSpec, або якщо вказати лише ім'я каталогу, але не включають будь-який файл специфікації, рядок буде змінено на "*. *".

Якщо lpPathSpec включає в себе диска і/або ім'я каталогу, поточного диска та каталог змінюються місця диск і каталогів перед заповнюється список. Текст елемента керування, визначені nIDStaticPath також буде оновлено з нового диска і/або ім'я каталогу.

Після заповнення списку, lpPathSpec оновлюється шляхом видалення диска і/або каталог частину шляху.

Огляд CWnd |nbsp; Члени класу | Ієрархічна діаграма

Дивіться такожnbsp;CWnd::DlgDirListComboBox, :: DlgDirList