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