DlgDirList

Funcţia DlgDirList umple caseta specificate în lista cu numele tuturor fişierelor de potrivire specifică calea sau numele fişierului.

int () DlgDirList HWND  hDlg, / / mâner de casetă de dialog cu caseta listăLPTSTRlpPathSpec, / / indicatorul şir calea sau numele fişieruluiintnIDListBox, / / identificator de casetă listăintnIDStaticPath, / / identificator de control staticeUINTuFileType / / Fişier atribute pentru a afişa);
 

Parametrii

hDlg

Mâner pentru caseta de dialog care conţine caseta listă.

lpPathSpec

Indicatorul un şir null-terminated care conţine calea sau numele fişierului. DlgDirList modifică acest şir, care ar trebui să fie suficient de lungă pentru a conţine modificările. Pentru mai multe informaţii despre acest parametru, consultaţi secţiunea observaţii.

nIDListBox

Precizează identificatorul de o casetă listă. Dacă acest parametru este zero, DlgDirList presupune că nici o casetă listă există şi nu încearcă să umple unul.

nIDStaticPath

Precizează identificatorul de control statice utilizate pentru afişarea curentă unitatea şi directorul. Dacă acest parametru este zero, DlgDirList presupune că nici un astfel de control este prezent.

uFileType

Precizează atributele de fişiere pentru a fi afişate. Acest parametru trebuie să fie una sau mai multe din următoarele valori:

Valoarea	Descriere
DDL_ARCHIVE	Include fişiere arhivate.
DDL_DIRECTORY	Include subdirectoare. Numele subdirector sunt închise în paranteze drepte ([]).
DDL_DRIVES	Include unităţile. Drive-urile sunt listate sub forma [-x-], unde x este litera de unitate.
DDL_EXCLUSIVE	Include numai fi?ierele cu atributele specificate. În mod implicit, fişierele de citire-scriere sunt enumerate chiar dacă nu este specificat DDL_READWRITE.
DDL_HIDDEN	Include fişiere ascunse.
DDL_READONLY	Include fi?iere doar-în-citire.
DDL_READWRITE	Include fişiere de citire-scriere, cu nici o atributele suplimentar.
DDL_SYSTEM	Include fi?iere de sistem.
DDL_POSTMSGS	Posturi mesajele de coada de mesaj aplicaţiei. Implicit, DlgDirList trimite mesaje direct la procedura de caseta de dialog.

Valorile întroarse

Dacă funcţia reuşeşte, valoarea returnată este nenul.

Dacă funcţia nu reuşeşte, valoarea returnată este zero. De exemplu, dacă şirul specificat de lpPathSpec nu este o cale validă, funcţia nu. Pentru a obţine extins informa?ii eroare, apel GetLastError.

Observaţii

Dacă specificaţi un şir de lungime zero pentru parametrul lpPathSpec sau dacă specificaţi numai un nume de director cu nici un nume de fişier, şirul va fi schimbat la *. *

Parametrul lpPathSpec are următoarea formă:

[unitate:] [[\u]director[\idirector] \u] [filename]

În acest exemplu, unitate este o literă de unitate, director este un nume valid director şi numele de fişier este un nume valid care trebuie să conţină cel puţin un metacaracter (? sau *).

Dacă lpPathSpec include o unitate sau numele directorului, sau ambele, unitatea curentă şi directorul sunt modificate specifică unitatea şi directorul înainte caseta listă este completat. Controlul statice identificate de parametrul nIDStaticPath este, de asemenea, actualizat cu noua unitate sau numele directorului sau ambele.

După ce caseta listă este completat, DlgDirList actualizări lpPathSpec prin eliminarea unitatea sau parte de director, sau ambele, calea şi numele fişierului.

DlgDirList a trimite mesajele LB_RESETCONTENT şi LB_DIR la caseta listă.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Neacceptat.
Antet:A declarat în winuser.h.
Import Biblioteca:Utilizarea user32.lib.
Unicode:Pus în aplicare ca Unicode şi ANSI versiuni Windows NT.

A se vedea, de asemenea

Lista casetele de prezentare generală, funcţii caseta listă, DlgDirListComboBox, DlgDirSelectComboBoxEx, DlgDirSelectEx

Index