GetSaveFileName

GetSaveFileName funkcia vytvára spoločné dialógové okno Uložiť , umožňuje používateľovi zadať jednotky, adresára a názov súboru na uloženie.

BOOL GetSaveFileName ( LPOPENFILENAME  lpofn / / address konštrukcie s Inicializácia / / údajov);
 

Parametre

lpofn
Smerník na štruktúru OPENFILENAME obsahujúci informácie použité pri inicializácii dialógového okna. Keď GetSaveFileName vráti, táto štruktúra obsahuje informácie o výber súborov používateľa.

Note:

Ak používateľ Určuje názov súboru a klikne na tlačidlo OK , vrátená hodnota je nenulové. Medzipamäť poukázal členskými lpstrFile OPENFILENAME štruktúra obsahuje úplnú cestu a názov súboru stanovenú používateľom.

Ak používateľ zruší alebo zavrie dialógové okno Uložiť alebo vyskytne chyba, vrátená hodnota je nula. Na získanie informácií o rozšírenej chybe, volajte CommDlgExtendedError funkcie môžu vrátiť jeden z nasledovných hodnôt:

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

Poznámky

V predvolenom nastavení systému Windows 95 alebo Windows NT verzia 4.0 zobrazte nová verzia dialógovom okne Uložiť poskytujúci funkcie používateľského rozhrania, ktoré sú podobné Windows Exploreru. OFNHookProc príslušná procedúra môže ustanoviť dialógové okno štýl Explorer uložte . Aby príslušná procedúra nastaviť príznak OFN_EXPLORER a OFN_ENABLEHOOK v členských štátoch vlajok OPENFILENAME štruktúry a zadať adresu príslušná procedúra v členských lpfnHook.

Systém Windows 95 alebo Windows NT 4.0 naďalej podporovať old-štýl dialógové okno Uložiť pre aplikácie, ktoré chcete ponechať používateľské rozhranie zlučiteľný s Windows 3.1 alebo Windows NT 3.51 používateľského rozhrania. Zobraziť dialógové okno Uložiť old-štýl, umožniť OFNHookProcOldStyle príslušná procedúra a aby sa zabezpečilo nie je nastavený príznak OFN_EXPLORER.

Windows CE: Nie všetci členovia OPENFILENAME štruktúry sú definované v systému Windows CE. Informácie o definované členov, nájdete v téme odkaz pre štruktúru OPENFILENAME .

Stručné informácie

nbsp; Systém Windows &NT: vyžaduje verzia 3.1 alebo novšia.
Windows:Vyžaduje systém Windows 95 alebo novším.
Windows CE:Vyžaduje verziu 1.0 alebo novšiu verziu.
Hlavičky:Deklarovaný v commdlg.h.
Importovať knižnica:Použiť comdlg32.lib.
Unicode:Implementovaný ako Unicode, ANSI verzia v systéme Windows NT.

Pozri tiež

Spoločné Prehľad dialógového okna Knižnica spoločných Dialog Box funkcií, CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME

Index