Funzione GetSaveFileNameA (commdlg.h)

Articolo
11/20/2024

[A partire da Windows Vista, le finestre di dialogo Apri e Salva con nome comuni sono state sostituite dalla finestra di dialogo elemento comune. È consigliabile usare l'API Della finestra di dialogo elementi comuni anziché queste finestre di dialogo dalla libreria della finestra di dialogo comune.]

Crea un finestra di dialogo Salva che consente all'utente di specificare l'unità, la directory e il nome di un file da salvare.

Sintassi

BOOL GetSaveFileNameA(
  [in, out] LPOPENFILENAMEA unnamedParam1
);

Parametri

[in, out] unnamedParam1

Tipo: LPOPENFILENAME

Puntatore a una struttura OPENFILENAME che contiene informazioni utilizzate per inizializzare la finestra di dialogo. Quando getSaveFileName restituisce, questa struttura contiene informazioni sulla selezione del file dell'utente.

Valore restituito

Tipo: bool

Se l'utente specifica un nome file e fa clic sul pulsante OK e la funzione ha esito positivo, il valore restituito è diverso da zero. Il buffer a cui punta il lpstrFile membro della struttura OPENFILENAME contiene il percorso completo e il nome file specificati dall'utente.

Se l'utente annulla o chiude il finestra di dialogo Salva o si verifica un errore, ad esempio il buffer dei nomi file troppo piccolo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare la funzione CommDlgExtendedError , che può restituire uno dei valori seguenti:

Osservazioni

Finestra di dialogo Salva in stile Esplora risorse che fornisce funzionalità dell'interfaccia utente simili a Esplora risorse. È possibile fornire un OFNHookProc routine hook per una finestra di dialogo salva in stile Explorer. Per abilitare la routine hook, impostare i flag OFN_EXPLORER e OFN_ENABLEHOOK nel membro flag della struttura OPENFILENAME e specificare l'indirizzo della routine hook nel membro lpfnHo ok.

Windows continua a supportare finestre di dialogo Salva vecchio stile per le applicazioni che vogliono mantenere un'interfaccia utente coerente con l'interfaccia utente precedente. Per visualizzare la finestra di dialogo Salva di stile precedente, abilitare una routine hook OFNHookProcOldStyle e assicurarsi che il flag OFN_EXPLORER non sia impostato.

Esempi

Per un esempio, vedere Creazione di un metafile avanzato.

Nota

L'intestazione commdlg.h definisce GetSaveFileName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	commdlg.h (include Windows.h)
libreria	Comdlg32.lib
dll	Comdlg32.dll
set di API	ext-ms-win-shell-comdlg32-l1-1-1 (introdotto in Windows 10, versione 10.0.14393)