GetOpenFileName

GetOpenFileName -funksjonen oppretter en felles dialogboksen Åpne som lar brukeren angi stasjonen, katalog, og navnet på en fil eller et sett med filer for å åpne.

BOOL GetOpenFileName) LPOPENFILENAME  lpofn / / adresse av strukturen med initialisering / / data);
 

Parametere

lpofn

Peker til en OPENFILENAME struktur som inneholder informasjon som brukes til å initialisere dialogboksen. Når GetOpenFileName kommer tilbake, inneholder denne strukturen informasjon om brukerens filutvalg.

Returverdier

Hvis brukeren angir et filnavn og klikker på OK -knappen, er returverdien ikke-null. Bufferen pekes til av lpstrFile -medlemmet av den OPENFILENAME -strukturen inneholder hele banen og filnavnet som er angitt av brukeren.

Hvis brukeren avbryter eller lukker dialogboksen Åpne , eller det oppstår en feil, er verdien som returneres Null. Vil ha utvidet feilinformasjon, kall funksjonen CommDlgExtendedError , som kan returnere en av følgende verdier:

Merknader

Begynner med Windows 95 og Windows NT versjon 4.0, gir dialogboksen Åpne standard brukergrensesnitt funksjoner som ligner Windows Utforsker. Du kan gi en OFNHookProc hook-prosedyre for en Explorer-stil Åpne dialogboksen. Hvis du vil aktivere Bindingsprosedyren, angi flagg for OFN_EXPLORER og OFN_ENABLEHOOK i flaggene -medlem av OPENFILENAME -strukturen og angi adressen til Bindingsprosedyren i lpfnHook -medlem.

Windows 95 og Windows NT kan du fortsette å støtte gammeldagse dialogboksen Åpne for programmer som ønsker å opprettholde et brukergrensesnitt som er konsekvent med Windows 3.1 eller Windows NT 3.51-brukergrensesnittet. Aktivere en OFNHookProcOldStyle Bindingsprosedyren vil vise gammeldagse dialogboksen Åpne , og sikre at flagget OFN_EXPLORER ikke er angitt.

Hvis du vil vise en dialogboks som lar brukeren velge en mappe i stedet for en fil, kaller den SHBrowseForFolder -funksjonen.

Windows CE: Ikke alle medlemmer av OPENFILENAME -strukturen defineres i Windows CE. Informasjon om medlemmer som er definert, kan du se emnet referanse for OPENFILENAME -struktur.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 1.0 eller senere.
Topptekst:Deklarert i commdlg.h.
Importere biblioteket:Bruk comdlg32.lib.
Unicode:Implementert som Unicode- og ANSI-versjoner på Windows NT.

Se også

Felles biblioteket dialogboksoversikt, felles dialogboksen fungerer, CommDlgExtendedError, GetSaveFileName, OFNHookProc , OFNHookProcOldStyle, OPENFILENAME, SHBrowseForFolder

Index