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);
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 |
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.
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.
Comuni Dialog Box Library panoramica, funzioni di dialogo comune, CommDlgExtendedError, GetSaveFileName, OFNHookProc , OFNHookProcOldStyle, OPENFILENAME, SHBrowseForFolder
Rimedio: Inserire il CD-ROM CD di MSDN Library.