DlgDirList

Funkcia DlgDirList vyplní špecifikovaných zozname s názvami všetkých súborov zodpovedajúcich zadaná cesta alebo názov súboru.

int DlgDirList ( HWND  hDlg; / / zvládnuť dialógové okno so zoznamomLPTSTRlpPathSpec; / / ukazovateľ cesta alebo názov súboru reťazecintnIDListBox; / / identifikátor zoznamomintnIDStaticPath; / / identifikátor statické kontrolyUINTuFileType / / súbor atribúty zobrazíte);
 

Parametre

hDlg

Spracovať do dialógového okna obsahujúci zozname.

lpPathSpec

Ukazovateľ zakončený reťazec, ktorý obsahuje cestu alebo názov súboru. DlgDirList upraví tento reťazec, ktorý by mal byť dostatočne dlhé na to, aby obsahoval zmeny. Ďalšie informácie o tento parameter, nájdete v časti poznámky.

nIDListBox

Určuje identifikátor zoznamom. Ak tento parameter nie je nula, DlgDirList predpokladá, že žiadne zozname existuje a nepokúša sa vyplniť jeden.

nIDStaticPath

Určuje identifikátor statické ovládací prvok používaný pri zobrazovaní aktuálnu jednotku a adresár. Ak tento parameter nie je nula, DlgDirList predpokladá, že takéto kontroly nie je prítomná.

uFileType

Určuje atribúty súborov sa zobrazí. Tento parameter musí byť jedným alebo viacerými z nasledovných hodnôt:

Hodnota	Popis
DDL_ARCHIVE	Zahŕňa archivovaných spisov.
DDL_DIRECTORY	Zahŕňa podadresáre. Názvy podadresárov sú uvedené v hranatých zátvorkách ([]).
DDL_DRIVES	Zahŕňa jednotky. Jednotky sú uvedené vo forme [-x-], kde x je písmeno jednotky.
DDL_EXCLUSIVE	Zahŕňa len súbory so zadanými atribútmi. V predvolenom nastavení, čítať a zapisovať súbory sú evidované dokonca aj vtedy, ak nie je zadaná DDL_READWRITE.
DDL_HIDDEN	Obsahuje skryté súbory.
DDL_READONLY	Obsahuje súbory iba na čítanie.
DDL_READWRITE	Zahŕňa čítanie aj zápis súborov pomocou ďalších atribútov.
DDL_SYSTEM	Obsahuje systémové súbory.
DDL_POSTMSGS	Príspevky správ do frontu správ aplikácie. Podľa predvoleného nastavenia DlgDirList odošle správy priamo do dialógového okna pole postup.

Note:

Ak funkciu podarí, vrátená hodnota je nenulové.

Ak funkcia zlyhá, vrátená hodnota je nula. Napríklad, ak reťazec určený lpPathSpec nie je platná cesta, funkcia zlyhá. Získajte rozšírené informácie o chybách, volajte na číslo GetLastError.

Poznámky

Ak zadáte reťazec s nulovou dĺžkou parametra lpPathSpec alebo ak zadáte iba názov adresára s no filename je reťazec sa zmení na *. *

LpPathSpec parameter má nasledovný formulár:

[disk:] [[\u]Adresár[\iAdresár] \u] [filename]

V tomto príklade jednotka predstavuje písmeno jednotky, adresára je platn2 adresßr meno a názov súboru je platný názov súboru, ktorý musí obsahovať aspoň jeden zástupný znak (? alebo *).

Ak lpPathSpec zahŕňa jednotky alebo názov adresára alebo oboje, aktuálnu jednotku a adresár sa zmenia na zadanej jednotke a adresári pred zozname je naplnená. Statické kontrolu identifikovaný parametrom nIDStaticPath sa takisto aktualizuje novej jednotky alebo názov adresára alebo oboje.

Po zozname je vyplnený, DlgDirList aktualizuje lpPathSpec odstránením jednotku alebo adresár časť alebo aj cestu a názov súboru.

DlgDirList odošle správy LB_RESETCONTENT a LB_DIR do zoznamu.

Stručné informácie

nbsp; Systém Windows &NT: vyžaduje verzia 3.1 alebo novšia.
Windows:Vyžaduje systém Windows 95 alebo novším.
Windows CE:Nepodporované.
Hlavičky:Deklarovaný v súbore winuser.h.
Importovať knižnica:Použiť user32.lib.
Unicode:Implementovaný ako Unicode, ANSI verzia v systéme Windows NT.

Pozri tiež

Zoznam polí prehľad zoznamu poľa funkcie, DlgDirListComboBox, DlgDirSelectComboBoxEx, DlgDirSelectEx

Index