GetOpenFileName

La funzione GetOpenFileName crea un aperto dialogo comune che consente all'utente di specificare l'unità, directory e il nome di un file o un insieme di file da aprire.

(BOOL GetOpenFileName 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 GetOpenFileName 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 Apri 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

A partire da Windows 95 e Windows NT versione 4.0, la finestra di dialogo Apri predefinito fornisce funzionalità di interfaccia utente simile a Windows Explorer. È possibile fornire una routine di hook OFNHookProc per un dialogo aperto tipo Esplora risorse. 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 continuare a sostenere il vecchio stile di dialogo Apri per le applicazioni che si desidera mantenere un'interfaccia utente coerente con Windows 3.1 o Windows NT 3.51 interfaccia utente. Per visualizzare il vecchio stile di dialogo Apri , attivare una procedura di gancio OFNHookProcOldStyle e verificare che il flag OFN_EXPLORER non è impostato.

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

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

Comuni Dialog Box Library panoramica, funzioni di dialogo comune, CommDlgExtendedError, GetSaveFileName, OFNHookProc , OFNHookProcOldStyle, OPENFILENAME, SHBrowseForFolder

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

Index