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);
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 |
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 .
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.
Wspólny omówienie biblioteki okna dialogowego, wspólne funkcje pole dialogowe, CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME