DlgDirListComboBox

Funcţia DlgDirListComboBox umple caseta combo specificate cu o listă de director. Se umple lista cu numele toate fişierele, unităţi şi subdirectoarele care se potrivesc specificat atribute şi calea şir.

int () DlgDirListComboBox HWND  hDlg, / / ocupa la caseta de dialog cu casetă comboLPTSTRlpPathSpec, / / indicatorul şir calea sau numele fişieruluiintnIDComboBox, / / identificator de casetă combointnIDStaticPath, / / identificator de control staticeUINTuFiletype / / Fişier atribute pentru a afişa);
 

Parametrii

hDlg

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

lpPathSpec

Indicatorul unui şir null-terminated următoarea formă:

[drive:][\]][director\[...]][Fişier]

Dacă şirul specificat include o unitate sau calea directorului, funcţia DlgDirListComboBox modifică unitatea curentă şi director înainte de umplere lista. După ce lista este completat, calea unitatea şi directorul sunt eliminate din şirul de caractere specificat de parametrul lpPathSpec.

nIDComboBox

Precizează identificatorul de un control casetă combo într-o casetă de dialog. În cazul în care nIDComboBox este zero, funcţia DlgDirListComboBox îşi asumă nici o casetă combo există şi nu încearcă să completaţi-l.

nIDStaticPath

Precizează identificatorul de control static text în care funcţia DlgDirListComboBox este de a afişa directorul curent. În cazul în care nIDStaticPath este zero, DlgDirListComboBox îşi asumă nici un astfel de control este prezent.

uFiletype

Precizează atributele de fişiere pentru a fi afişate. Poate fi orice combinaţie de următoarele valori:

Valoarea	Sensul
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, funcţia de DlgDirList a 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ă parametrul lpszPathSpec puncte la un şir de lungime zero sau un şir care specifică o unitate, director, sau ambele-dar nici un nume de fişier — numele de fişier *. * (metacaractere) este asumată.

Windows NT:

Listare director afişează numele de fişiere lungi, dacă este cazul.

Windows 95:

Listare director afişează numele fişierelor scurt (formularul 8.3). Se pot utiliza funcţiile SHGetFileInfo sau GetFullPathName pentru a obţine numele de fişier lung corespunzătoare.

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

Prezentare generală a casete combo, Casetă Combo funcţii, DlgDirList, DlgDirSelectComboBoxEx, GetFullPathName, SHGetFileInfo

Index