DlgDirList

De functie DlgDirList vult de opgegeven keuzelijst met de namen van alle bestanden die overeenkomen met het opgegeven pad of de bestandsnaam.

int () DlgDirList HWND  hDlg, / / ingang naar het dialoogvenster met keuzelijstLPTSTRlpPathSpec, / / aanwijzer op pad of bestandsnaam tekenreeksintnIDListBox, / / id van keuzelijstintnIDStaticPath, / / id van statische besturingselementUINTuFileType / / bestand kenmerken weergeven);
 

Parameters

hDlg
Ingang naar het dialoogvenster dat de keuzelijst bevat.
lpPathSpec
Aanwijzer naar een op null eindigende tekenreeks met het pad of de bestandsnaam. DlgDirList wijzigt deze tekenreeks, die moet lang genoeg zijn om de wijzigingen bevatten. Zie het gedeelte opmerkingen voor meer informatie over deze parameter.
nIDListBox
Hiermee geeft u de id van een keuzelijst. Als deze parameter nul is, DlgDirList wordt verondersteld dat geen keuzelijst bestaat en wordt niet geprobeerd te vullen een.
nIDStaticPath
Hiermee geeft u de id van het statische besturingselement wordt gebruikt voor het weergeven van het huidige station en de map. Als deze parameter nul is, DlgDirList wordt ervan uitgegaan dat er geen dergelijke controle aanwezig is.
uFileType
Hiermee geeft u de kenmerken van de bestandsnamen worden weergegeven. Deze parameter moet een of meer van de volgende waarden:
Waarde Beschrijving
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. DlgDirList verzendt standaard 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 u een tekenreeks met lengte nul voor de parameter lpPathSpec opgeeft of als u alleen de naam van een map met geen bestandsnaam opgeeft, wordt de tekenreeks gewijzigd in *. *

De parameter lpPathSpec heeft de volgende vorm:

[station:] [[\u]map[\imap] \u] [bestandsnaam]

In dit voorbeeld is station een stationsletter, Folder is een geldige mapnaam en bestandsnaam is een geldige bestandsnaam die moet ten minste één jokerteken bevatten (? of *).

Als lpPathSpec een station of mapnaam, of beide bevat, zijn het huidige station en de map gewijzigd in het opgegeven station en de map voordat de keuzelijst wordt gevuld. Het statische besturingselement geïdentificeerd door de parameter nIDStaticPath is ook bijgewerkt met het nieuwe station en/of mapnaam.

Nadat de keuzelijst wordt gevuld, werkt DlgDirList lpPathSpec door het verwijderen van de schijf of map deel, of beide, van het pad en de bestandsnaam.

DlgDirList verzendt de LB_RESETCONTENT en LB_DIR naar de keuzelijst.

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

Lijst vakken overzicht, lijst vak functies, DlgDirListComboBox, DlgDirSelectComboBoxEx, DlgDirSelectEx

Index