DlgDirListComboBox

De functie DlgDirListComboBox vult de opgegeven keuzelijst met invoervak met een directory listing. Het vult de lijst met de namen van alle bestanden, stations en submappen die overeenkomen met de opgegeven kenmerken en pad tekenreeks.

int () DlgDirListComboBox HWND  hDlg, / / ingang naar het dialoogvenster met de keuzelijst met invoervakLPTSTRlpPathSpec, / / aanwijzer op pad of bestandsnaam tekenreeksintnIDComboBox, / /-id van de keuzelijst met invoervakintnIDStaticPath, / / id van statische besturingselementUINTuFiletype / / bestand kenmerken weergeven);
 

Parameters

hDlg

Ingang naar het dialoogvenster dat de keuzelijst met invoervak bevat.

lpPathSpec

Pointer naar een op null eindigende tekenreeks van het volgende formulier:

[drive:][\]][directory\[...]][bestandsnaam]

Als de opgegeven tekenreeks een station of map pad, de DlgDirListComboBox functie wijzigingen bevat het huidige station en de map voor het vullen van de lijst. Nadat de lijst gevuld is, het station en de map pad zijn verwijderd uit de tekenreeks die wordt opgegeven door de parameter lpPathSpec.

nIDComboBox

Hiermee geeft u de id van een keuzelijst met invoervak in een dialoogvenster. Als nIDComboBox nul is, de DlgDirListComboBox functie wordt verondersteld geen keuzelijst met invoervak bestaat en wordt niet geprobeerd om het te vullen.

nIDStaticPath

Hiermee geeft u de id van het besturingselement van de statische tekst waarin de DlgDirListComboBox functie is om de huidige map weer te geven. Als nIDStaticPath gelijk is aan nul, DlgDirListComboBox wordt aangenomen dat geen dergelijke controle aanwezig is.

uFiletype

Hiermee geeft u de kenmerken van de bestanden moet worden weergegeven. Het kan een willekeurige combinatie van de volgende waarden worden:

Waarde	Betekenis
DDL_ARCHIVE	Gearchiveerde bestanden bevat.
DDL_DIRECTORY	Omvat subdirectories. Submap namen zijn tussen vierkante haken ([]).
DDL_DRIVES	Bevat stations. Schijven staan in de vorm [-x-], waarbij x de stationsletter is.
DDL_EXCLUSIVE	Bevat alleen de bestanden met de opgegeven kenmerken. Standaard, worden lezen-schrijven bestanden weergegeven, zelfs als DDL_READWRITE niet is opgegeven.
DDL_HIDDEN	Verborgen bestanden bevat.
DDL_READONLY	Bevat alleen-lezen bestanden.
DDL_READWRITE	Lezen-schrijven bestanden zonder extra kenmerken bevat.
DDL_SYSTEM	Bevat systeembestanden.
DDL_POSTMSGS	Berichten voor de berichtenwachtrij van de toepassing. Standaard verzendt de DlgDirList functie berichten rechtstreeks naar het dialoogvenster vak procedure.

Retourwaarden

Als de functie slaagt, is de retourwaarde aan nul.

Als de functie mislukt, is de retourwaarde nul. Bijvoorbeeld, als de tekenreeks die wordt opgegeven door lpPathSpec geen geldig pad is, mislukt de bewerking. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

Als de parameter lpszPathSpec wijst naar een tekenreeks met lengte nul of een tekenreeks opgeven voor een schijf, map of beide — maar geen bestandsnaam — de bestandsnaam *. * (jokertekens) wordt aangenomen.

Windows NT:

De folderlijst toont lange bestandsnamen, eventuele.

Windows 95:

De folderlijst toont korte bestandsnamen (de 8.3 vorm). U kunt de functie SHGetFileInfo of GetFullPathName om de overeenkomstige lange bestandsnaam.

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Niet-ondersteunde.
Header:Verklaard in winuser.h.
Bibliotheek importeren:User32.lib gebruiken.
Unicode:Geïmplementeerd als Unicode en ANSI-versies van Windows NT.

Zie ook

Combo Boxes overzicht, keuzelijst met invoervak functioneert, DlgDirList, DlgDirSelectComboBoxEx, GetFullPathName, SHGetFileInfo

Index