GetSaveFileName

La funzione GetSaveFileName crea una salvare dialogo comune che consente all'utente di specificare l'unità, directory e il nome di un file da salvare.

(BOOL GetSaveFileName LPOPENFILENAME  lpofn / / indirizzo della struttura con l'inizializzazione / / dati);
 

Parametri

lpofn
Puntatore a una struttura OPENFILENAME che contiene le informazioni utilizzate per inizializzare la finestra di dialogo. Quando GetSaveFileName ritorna, questa struttura contiene informazioni sulla selezione di file dell'utente.

Valori restituiti

Se l'utente specifica un nome di file e fa clic sul pulsante OK , il valore restituito è diverso da zero. Il buffer a cui puntato il membro lpstrFile della struttura OPENFILENAME contiene il percorso completo e il nome file specificato dall'utente.

Se l'utente annulla o si chiude la finestra di dialogo di salvataggio o si verifica un errore, il valore restituito è zero. Per ottenere informazioni sull'errore esteso, chiamare la funzione CommDlgExtendedError , che può restituire uno dei seguenti valori:

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

Osservazioni

Per impostazione predefinita, Windows 95 e Windows NT versione 4.0 visualizzare una nuova versione della finestra di dialogo Salva che fornisce funzionalità di interfaccia utente simile a Windows Explorer. È possibile fornire una routine di hook OFNHookProc per una finestra di dialogo stile Explorer Salva . Per abilitare la routine di hook, impostare il flag OFN_EXPLORER e OFN_ENABLEHOOK nel membro Flags della struttura OPENFILENAME e specificare l'indirizzo della procedura gancio nel membro lpfnHook.

Windows 95 e Windows NT 4.0 continuare a sostenere il vecchio stile di dialogo Salva per le applicazioni che si desidera mantenere un'interfaccia utente coerente con Windows 3.1 o Windows NT 3.51 interfaccia utente. Per visualizzare la finestra di dialogo Salva vecchio stile, attivare una procedura di gancio OFNHookProcOldStyle e verificare che il flag OFN_EXPLORER non è impostato.

Windows CE: Non tutti i membri della struttura OPENFILENAME sono definiti in Windows CE. Per informazioni sui membri definiti, vedere l'argomento di riferimento per la struttura OPENFILENAME .

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in commdlg.h.
Importare librerie:Utilizzare comdlg32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

Comune di dialogo casella libreria panoramica, funzioni di Box di dialogo comuni, CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index