Funzione GetOpenFileNameA (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 Apri che consente all'utente di specificare l'unità, la directory e il nome di un file o di un set di file da aprire.

Sintassi

BOOL GetOpenFileNameA(
  [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 getOpenFileName 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, 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 Apri o si verifica un errore, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare la funzione CommDlgExtendedError, che può restituire uno dei valori seguenti.

Osservazioni

La finestra di dialogo Apri in stile Esplora risorse fornisce funzionalità dell'interfaccia utente simili a Esplora risorse. È possibile specificare una procedura hook OFNHookProc per una finestra di dialogo Apri di 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 la finestra di dialogo Apri di vecchio stile per le applicazioni che vogliono mantenere un'interfaccia utente coerente con l'interfaccia utente precedente. Per visualizzare la finestra di dialogo Apri precedente, abilitare una routine hook OFNHookProcOldStyle e assicurarsi che il flag OFN_EXPLORER non sia impostato.

Per visualizzare una finestra di dialogo che consente all'utente di selezionare una directory anziché un file, chiamare la funzione SHBrowseForFolder .

Quando si selezionano più file, il limite di caratteri totale per i nomi di file dipende dalla versione della funzione.

ANSI: limite di 32k
Unicode: nessuna restrizione

Esempi

Per un esempio, vedere Apertura di un file.

Nota

L'intestazione commdlg.h definisce GetOpenFileName 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)