GetSaveFileName

Funkcja GetSaveFileName tworzy zapisać wspólne okno dialogowe, które pozwala użytkownikowi określenie dysku, katalogu i nazwę pliku do zapisania.

(BOOL GetSaveFileName LPOPENFILENAME  lpofn / / adresu struktury z inicjowania / / danych);
 

Parametry

lpofn
Wskaźnik do struktury OPENFILENAME , który zawiera informacje używane do inicjowania okna dialogowego. Po GetSaveFileName , ta struktura zawiera informacje o wybór pliku użytkownika.

Zwraca wartości

Jeśli użytkownik określa nazwę pliku i klika przycisk OK , wartość zwracany jest różna od zera. Bufor wskazywanego przez członka lpstrFile struktury OPENFILENAME zawiera pełną ścieżkę i nazwę pliku określonego przez użytkownika.

Jeśli użytkownik anuluje lub zamyka okno dialogowe Zapisywanie lub wystąpi błąd, wartość zwracany jest równa zero. Aby uzyskać informacje o błąd rozszerzony, wywołać funkcję CommDlgExtendedError , która może zwracać jeden z następujących wartości:

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

Uwagi

Domyślnie system Windows 95 i Windows NT w wersji 4.0 wyświetlić nową wersję okno dialogowe Zapisz , który udostępnia funkcje interfejsu użytkownika, które są podobne do okna programu Eksplorator. Procedura haka OFNHookProc może przewidywać okno dialogowe stylu eksploratora, Zapisz . Aby włączyć procedura haka, ustawić flagi OFN_EXPLORER i OFN_ENABLEHOOK w Państwa flag struktury OPENFILENAME i określić adres procedura haka członka lpfnHook.

Windows 95 i Windows NT 4.0 dalej wspierać starym stylu dialogowym Zapisywanie dla aplikacji, które chcą utrzymać interfejs użytkownika zgodny z systemu Windows 3.1 lub interfejs użytkownika systemu Windows NT 3.51. Aby wyświetlić starym stylu dialogowym Zapisywanie , Włącz procedura haka OFNHookProcOldStyle i zapewnienia, że nie jest ustawiona flaga OFN_EXPLORER.

Systemu Windows CE: Nie wszystkie elementy konstrukcji OPENFILENAME są zdefiniowane w systemu Windows CE. Dla informacji na temat określonych członków zobacz temat odniesienia do struktury OPENFILENAME .

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w commdlg.h.
Importowanie biblioteki:Należy użyć comdlg32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Wspólny omówienie biblioteki okna dialogowego, wspólne funkcje pole dialogowe, CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME

Index