Funksjonen DlgDirList fyller boksen spesifisert liste med navnene i alle filene som samsvarer med angitt bane eller filnavn.
int () DlgDirList HWND hDlg, / / håndtere til dialogboks med listeLPTSTRlpPathSpec, / / peker til bane eller filnavn strengIntnIDListBox, / / identifikator for listenIntnIDStaticPath, / / identifikator for statisk kontrollUINTuFileType / / fil attributter for å vise);
Verdi | Beskrivelse |
---|---|
DDL_ARCHIVE | Inkluderer arkiverte filer. |
DDL_DIRECTORY | Inkluderer undermapper. Undermappene er omsluttet av hakeparenteser ([]). |
DDL_DRIVES | Inkluderer stasjoner. Nettverksstasjoner står oppført i skjemaet [-x-], der x er stasjonsbokstaven. |
DDL_EXCLUSIVE | Omfatter bare filer med angitte attributter. Lese-skrive-filer vises som standard, selv om DDL_READWRITE ikke er angitt. |
DDL_HIDDEN | Inkluderer skjulte filer. |
DDL_READONLY | Inneholder skrivebeskyttede filer. |
DDL_READWRITE | Omfatter filer for lese-og skrivetilgang med ingen tilleggsattributter. |
DDL_SYSTEM | Inkluderer systemfiler. |
DDL_POSTMSGS | Bokfører meldinger til programmets meldingskøen. Som standard sender DlgDirList meldinger direkte til dialogboksen boksen prosedyre. |
Hvis funksjonen lykkes, er returverdien ikke-null.
Hvis funksjonen mislykkes, er verdien som returneres Null. For eksempel hvis strengen som er angitt av lpPathSpec ikke er en gyldig bane, mislykkes funksjonen. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.
Hvis du angir en tom streng for lpPathSpec -parameteren, eller hvis du angir et mappenavn med ingen filnavn, strengen vil bli endret til *. *
Parameteren lpPathSpec har skjemaet følgende:
[stasjonen:] [[\u]directory[\idirectory] \u] [filnavn[]
I dette eksemplet stasjon er en stasjonsbokstav, katalogen er et gyldig mappenavn og filnavn er et gyldig filnavn må inneholde minst én jokertegn (? eller *).
Hvis lpPathSpec inneholder en stasjon eller katalognavn eller begge deler, endres gjeldende stasjon og mappe til den angitte stasjonen og katalogen før listeboksen er fylt. Statisk kontrollen identifisert av parameteren nIDStaticPath er også oppdatert med den nye stasjonen og/eller mappenavn.
Når listen er fylt, oppdaterer DlgDirList lpPathSpec ved å fjerne stasjonen eller directory-delen, eller begge deler, av banen og filnavnet.
DlgDirList sender meldingene LB_RESETCONTENT og LB_DIR til listeboksen.
nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Som ikke støttes.
Topptekst:Deklarert i winuser.h.
Importere biblioteket:Bruk user32.lib.
Unicode:Implementert som Unicode- og ANSI-versjoner på Windows NT.
Listen boksene oversikt, listen fungerer, DlgDirListComboBox, DlgDirSelectComboBoxEx, DlgDirSelectEx