DlgDirListComboBox

Funksjonen DlgDirListComboBox fyller angitte kombinasjonsboksen med en adresseliste-katalogiserer. Fyller det listen med navnene på alle filer, stasjoner og undermapper som samsvarer med de angitte attributtene og banestreng.

int () DlgDirListComboBox HWND  hDlg, / / håndtere til dialogboksen med kombinasjonsboksLPTSTRlpPathSpec, / / peker til bane eller filnavn strengIntnIDComboBox, / / identifikator for kombinasjonsboksIntnIDStaticPath, / / identifikator for statisk kontrollUINTuFiletype / / fil attributter for å vise);
 

Parametere

hDlg

Håndtere til dialogboksen som inneholder kombinasjonsboksen.

lpPathSpec

Pekeren til en null-terminert streng i følgende form:

[drive:][\]][directory\[...]][filnavn]

Hvis den angitte strengen inneholder en stasjon eller banen, DlgDirListComboBox funksjonen endringene gjeldende stasjon og mappe før å fylle listen. Når listen er fylt, stasjon og mappe banen er fjernet fra strengen som er angitt av parameteren lpPathSpec.

nIDComboBox

Angir identifikatoren til en kombinasjonsbokskontroll i en dialogboks. Hvis nIDComboBox er null, forutsetter DlgDirListComboBox funksjonen ingen kombinasjonsboks finnes, og prøver ikke å fylle det.

nIDStaticPath

Angir identifikatoren til statisk tekstkontrollen der funksjonen DlgDirListComboBox , er å vise gjeldende mappe. Hvis nIDStaticPath er null, forutsetter DlgDirListComboBox ingen slik kontroll er til stede.

uFiletype

Angir attributtene for filer som skal vises. Det kan være en kombinasjon av følgende verdier:

Verdi	Betydning
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 funksjonen 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 parameteren lpszPathSpec peker til en tom streng eller en streng som angir en stasjon, mappe eller begge — men ingen filnavn – filnavnet *. * antas (jokertegn).

Windows NT:

Adresseliste-katalogiserer viser lange filnavn, hvis noen.

Windows 95:

Adresseliste-katalogiserer viser korte filnavn (8.3-skjemaet). Du kan bruke funksjonene SHGetFileInfo eller GetFullPathName for å få tilsvarende lange filnavn.

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å

Combo boksene oversikt, kombinasjonsboks fungerer, DlgDirList, DlgDirSelectComboBoxEx, GetFullPathName, SHGetFileInfo

Index