DlgDirList

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);
 

Parametere

hDlg
Håndtere til dialogboksen som inneholder listen.
lpPathSpec
Pekeren til en null-terminert streng som inneholder bane eller filnavn. DlgDirList endrer denne strengen, som bør være lenge nok til å inneholde endringene. Hvis du vil ha mer informasjon om denne parameteren, se under Merknader.
nIDListBox
Angir identifikatoren til en liste. Hvis denne parameteren er null, forutsetter DlgDirList at ingen listen finnes, og at de prøver ikke å fylle en.
nIDStaticPath
Angir identifikatoren til statisk kontrollen brukes til å vise gjeldende stasjon og mappe. Hvis denne parameteren er null, forutsetter DlgDirList at det finnes ingen slik kontroll.
uFileType
Angir attributter for filnavnene som skal vises. Denne parameteren må være én eller flere av følgende verdier:
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.

Returverdier

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.

Merknader

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.

Hurtiginformasjon

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.

Se også

Listen boksene oversikt, listen fungerer, DlgDirListComboBox, DlgDirSelectComboBoxEx, DlgDirSelectEx

Index