DlgDirList

Funkcja DlgDirList wypełnienia pola listy określonej nazwy wszystkich plików określona ścieżka lub nazwa pliku.

int DlgDirList ( HWND  hDlg, / / dojście do okna dialogowego pole z listyLPTSTRlpPathSpec, / / wskaźnik na ciąg, ścieżka lub nazwa plikuintnIDListBox, / / identyfikator pola listyintnIDStaticPath, / / identyfikator formantu statyczneUINTuFileType / / atrybuty do wyświetlenia pliku);
 

Parametry

hDlg

Dojście do okna dialogowego, który zawiera pole listy.

lpPathSpec

Wskaźnik na ciąg zakończony znakiem null, który zawiera ścieżkę lub nazwę pliku. DlgDirList modyfikuje ten ciąg, który powinien być dostatecznie długi zawiera modyfikacje. Aby uzyskać więcej informacji na temat tego parametru zobacz sekcję Spostrzeżenia.

nIDListBox

Określa identyfikator pola listy. Jeśli ten parametr jest równy zero, DlgDirList zakłada, że nie pole listy istnieje i nie próbuje wypełnić jeden.

nIDStaticPath

Określa identyfikator statyczne formant używany do wyświetlania bieżącego dysku i katalogu. Jeśli ten parametr jest równy zero, DlgDirList zakłada, że brak takich kontroli jest obecny.

uFileType

Określa atrybuty plików mają być wyświetlane. Ten parametr musi być jeden lub więcej z następujących wartości:

Wartość	Opis
DDL_ARCHIVE	Zawiera zarchiwizowanych plików.
DDL_DIRECTORY	Zawiera podkatalogów. Nazwy podkatalogu są ujęte w nawiasy kwadratowe ([]).
DDL_DRIVES	Zawiera dyski. Dyski są wymienione w formularzu [-x-], gdzie x to litera dysku.
DDL_EXCLUSIVE	Dotyczy tylko plików o określonych atrybutach. Domyślnie odczytu i zapisu plików są wymienione, nawet, jeśli nie określono DDL_READWRITE.
DDL_HIDDEN	Zawiera ukryte pliki.
DDL_READONLY	Zawiera pliki tylko do odczytu.
DDL_READWRITE	Obejmuje pliki odczytu i zapisu z nie dodatkowych atrybutów.
DDL_SYSTEM	Zawiera pliki systemowe.
DDL_POSTMSGS	Księguje wiadomości do kolejki wiadomości aplikacji. Domyślnie DlgDirList wysyła wiadomości bezpośrednio do procedury pole dialogowe.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest różna od zera.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Na przykład jeśli ciąg określony przez lpPathSpec nie jest prawidłową ścieżką, nie działa funkcja. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Jeśli zostanie określona dla parametru lpPathSpec ciąg o zerowej długości lub Jeśli określisz tylko nazwę katalogu z żadnej nazwy pliku, ciąg zostanie zmieniony na *. *

Parametr lpPathSpec ma następującą postać:

[dysk:] [[\u]Katalog[\iKatalog] \u] [pliku]

W tym przykładzie dysku jest literą dysku, katalogu jest prawidłowa nazwa katalogu i Nazwa pliku jest prawidłową nazwą pliku, który musi zawierać co najmniej jeden symbol wieloznaczny (? i *).

Jeśli lpPathSpec zawiera dysk lub nazwę katalogu lub oba, bieżącego dysku i katalogu są zmieniane na określonym dysku i katalogu przed zrealizowaniem pole listy. Statyczne kontroli określonych przez parametr nIDStaticPath jest także aktualizowane z nowego dysku, nazwę katalogu lub oba.

Po polu listy jest wypełniany, DlgDirList aktualizuje lpPathSpec przez usunięcie dysku lub części katalogu lub obydwu, ścieżkę i nazwę pliku.

DlgDirList wysyła wiadomości LB_RESETCONTENT i LB_DIR do pola listy.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Należy użyć user32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Lista pól omówienie, funkcje pola listy, DlgDirListComboBox, DlgDirSelectComboBoxEx, DlgDirSelectEx

Index