int DlgDirList ( LPTSTR lpPathSpec, int nIDListBox, int nIDStaticPath, UINT nFileType );
Возвращаемое значение
Ненулевое значение, если функция выполнена успешно; в противном случае 0.
Параметры
lpPathSpec
Указывает на ограниченную значением null строку, содержащую путь или имя файла. DlgDirList изменяет эту строку, которая должна быть достаточно долго, чтобы содержать изменения. Для получения дополнительной информации смотрите в следующем разделе «Примечания».
nIDListBox
Указывает идентификатор списка. Если nIDListBox равен 0, DlgDirList предполагается, что окно не список существует и не пытается заполнить один.
nIDStaticPath
Указывает идентификатор static текстовый элемент управления, используемый для отображения текущего диска и каталога. Если nIDStaticPath равен 0, DlgDirList предполагает, что нет такой текстовый элемент управления присутствует.
nFileType
Указывает атрибуты файлов для отображения. Она может быть любым сочетанием следующих значений:
Примечания
Заполняет список с перечислением файла или каталога. Отправляет DlgDirList LB_RESETCONTENT и LB_DIR сообщения в списке. Он заполняет поле списка, определяемого nIDListBox с именами всех файлов, которые соответствуют путь lpPathSpec.
Параметр lpPathSpec имеет следующий вид:
[диск:] [[\u]каталог[каталог\i]... \u] [имя файла]
В этом примере диск — буква диска, каталог является правильное имя папки и имя файла является допустимое имя файла, который должен содержать по крайней мере один символ. Подстановочные знаки являются вопросительный знак (?), что означает соответствие любому символу и звездочки (**), т.е. соответствует любое количество символов.
Если вы укажите строку длины 0 для lpPathSpec, или если указано только имя каталога, но не включает каких-либо файл спецификации, строка будет изменено на "*. *".
Если lpPathSpec включает имя диска или каталога, текущий диск и каталог изменяются на назначенный диск и каталог, прежде чем заполнить поле со списком. Текстовый элемент управления, определяется nIDStaticPath также обновляется с нового диска или имя каталога.
После заполнения поле со списком lpPathSpec обновляется путем удаления дисков и папок часть пути.
Обзор CWnd |nbsp; Члены класса | Иерархическая схема
См. такжеnbsp;CWnd::DlgDirListComboBox, :: DlgDirList