GetSaveFileName

GetSaveFileName -funksjonen oppretter en felles dialogboksen Lagre som lar brukeren angi stasjon, katalog og navnet på en fil for å lagre.

BOOL GetSaveFileName) 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 GetSaveFileName 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 Lagre 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:

CDERR_FINDRESFAILURE CDERR_NOHINSTANCE
CDERR_INITIALIZATION CDERR_NOHOOK
CDERR_LOCKRESFAILURE CDERR_NOTEMPLATE
CDERR_LOADRESFAILURE CDERR_STRUCTSIZE
CDERR_LOADSTRFAILURE FNERR_BUFFERTOOSMALL
CDERR_MEMALLOCFAILURE FNERR_INVALIDFILENAME
CDERR_MEMLOCKFAILURE FNERR_SUBCLASSFAILURE

Merknader

Som standard vises en ny versjon av dialogboksen Lagre som inneholder-brukergrensesnittet-funksjoner som ligner Windows Utforsker i Windows 95 og Windows NT versjon 4.0. Du kan gi en OFNHookProc hook-prosedyre for en Explorer-stil Lagre -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 4.0 kan du fortsette å støtte gammeldagse dialogboksen Lagre for programmer som ønsker å opprettholde et brukergrensesnitt som er konsekvent med Windows 3.1 eller Windows NT 3.51-brukergrensesnittet. Aktivere en OFNHookProcOldStyle hook-prosedyre vil vise gammeldagse dialogboksen Lagre , og sikre at flagget OFN_EXPLORER ikke er angitt.

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, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME

Index