Finestre di dialogo Apri e Salva con nome

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

La finestra di dialogo Apri consente all'utente di specificare l'unità, la directory e il nome di un file o di un set di file da aprire. Per creare e visualizzare una finestra di dialogo Apri , inizializzare una struttura OPENFILENAME e passare la struttura alla funzione GetOpenFileName .

La finestra di dialogo Salva con nome consente all'utente di specificare l'unità, la directory e il nome di un file da salvare. Per creare e visualizzare una finestra di dialogo Salva con nome, inizializzare una struttura OPENFILENAME e passare la struttura alla funzione GetSaveFileName .

Le finestre di dialogo Apri e Salva con nome in stile Esplora risorse offrono funzionalità dell'interfaccia utente simili a Esplora risorse. Tuttavia, il sistema continua a supportare le finestre di dialogo Apri e Salva con nome precedenti per le applicazioni che devono essere coerenti con l'interfaccia utente precedente.

Oltre alla differenza di aspetto, le finestre di dialogo in stile Explorer e vecchio stile differiscono per l'uso di modelli personalizzati e procedure hook per personalizzare le finestre di dialogo. Tuttavia, le finestre di dialogo in stile Esplora risorse e vecchio stile hanno lo stesso comportamento per la maggior parte delle operazioni di base, ad esempio specificando un filtro di nome file, convalidando l'input dell'utente e ottenendo il nome file specificato dall'utente. Per altre informazioni sulle finestre di dialogo in stile Esplora risorse e stile precedente, vedere Personalizzazione della finestra di dialogo Apri e salva con nome.

La figura seguente mostra una tipica finestra di dialogo Apri in stile Esplora risorse.

Nella figura seguente viene illustrata una tipica finestra di dialogo Salva con nome in stile Esplora risorse.

Se l'utente specifica un nome file e fa clic sul pulsante OK , GetOpenFileName o GetSaveFileName restituisce TRUE. Il buffer a cui punta il membro lpstrFile della struttura OPENFILENAME contiene il percorso completo e il nome file specificati dall'utente.

Se l'utente annulla la finestra di dialogo Apri o Salva con nome o si verifica un errore, la funzione restituisce FALSE. Per determinare la causa dell'errore, chiamare la funzione CommDlgExtendedError per recuperare il valore di errore esteso. Se il buffer lpstrFile è troppo piccolo per ricevere il nome completo, CommDlgExtendedError restituisce FNERR_BUFFERTOOSMALL e i primi 2 byte del buffer a cui punta il membro lpstrFile vengono impostati su un valore intero che specifica le dimensioni necessarie per ricevere il nome completo.

In questa sezione vengono illustrati gli argomenti seguenti.

• Nomi di file e directory
• Filtri
• Convalida di file e directory
• Personalizzazione della finestra di dialogo Apri e salva con nome
• Procedure hook di tipo Explorer
• Modelli personalizzati in stile Esplora risorse
• Identificatori di controllo in stile Explorer
• Personalizzazione delle finestre di dialogo Old-Style

Nomi di file e directory

Le informazioni contenute in questa sezione si applicano alle finestre di dialogo Apri e Salva con nome in stile precedente e in stile precedente.

Prima di chiamare le funzioni GetOpenFileName o GetSaveFileName , il membro lpstrFile della struttura OPENFILENAME deve puntare al buffer per ricevere il nome del file. Il membro nMaxFile deve specificare le dimensioni, in caratteri, del buffer lpstrFile . Per una funzione ANSI si tratta del numero di byte, ma per una funzione Unicode questo è il numero di caratteri.

Se l'utente specifica un nome file e fa clic sul pulsante OK , la finestra di dialogo copia l'unità, la directory e il nome file selezionati nel buffer lpstrFile . La funzione imposta anche i membri nFileOffset e nFileExtension rispettivamente agli offset, in caratteri, dall'inizio del buffer al nome del file e all'estensione del nome file.

Per recuperare solo il nome e l'estensione del file, impostare il membro lpstrFileTitle in modo che punti a un buffer e impostare il membro nMaxFileTitle sulle dimensioni, in caratteri, del buffer. In alternativa, è possibile passare il buffer lpstrFile in una chiamata alla funzione GetFileTitle per ottenere il nome visualizzato del file selezionato. Si noti, tuttavia, che il nome file restituito da GetFileTitle include un'estensione solo se si tratta della preferenza dell'utente per la visualizzazione dei nomi di file.

La finestra di dialogo utilizza la directory corrente per il processo chiamante come directory iniziale da cui visualizzare file e directory. Usare le funzioni GetCurrentDirectory e SetCurrentDirectory per ottenere e modificare la directory corrente di un processo. Per specificare una directory iniziale diversa senza modificare la directory corrente, usare il membro lpstrInitialDir per specificare il nome di una directory. La finestra di dialogo modifica automaticamente la directory corrente quando l'utente seleziona un'unità o una directory diversa. Per impedire alla finestra di dialogo di modificare la directory corrente, impostare il flag di OFN_NOCHANGEDIR . Questo flag non impedisce all'utente di modificare le directory per trovare un file.

Per specificare un'estensione del nome file predefinita, usare il membro lpstrDefExt . Se l'utente specifica un nome file che non dispone di un'estensione, la finestra di dialogo aggiunge l'estensione predefinita. Se si specifica un'estensione predefinita e l'utente specifica un nome di file con un'estensione diversa, la finestra di dialogo imposta il flag OFN_EXTENSIONDIFFERENT .

Per consentire all'utente di selezionare più file da una directory, impostare il flag di OFN_ALLOWMULTISELECT . Per la compatibilità con le applicazioni precedenti, la finestra di dialogo di selezione multipla predefinita usa l'interfaccia utente precedente. Per visualizzare una finestra di dialogo di selezione multipla in stile Esplora risorse, è necessario impostare anche il flag di OFN_EXPLORER .

Se l'utente seleziona più file, il buffer a cui punta il membro lpstrFile restituisce il percorso della directory corrente seguita dai nomi di file dei file selezionati. Il membro nFileOffset è l'offset al nome del primo file e il membro nFileExtension non viene utilizzato. Nella tabella seguente viene descritta la differenza tra le finestre di dialogo in stile Explorer e in stile obsoleto nella restituzione di più nomi di file.

È possibile usare la funzione FindFirstFile per eseguire la conversione tra nomi di file lunghi e brevi.

Se si specifica OFN_ALLOWMULTISELECT e l'utente seleziona un solo file, la stringa lpstrFile non dispone di un separatore tra il percorso e il nome del file.

Filtri

Le informazioni contenute in questa sezione si applicano alle finestre di dialogo Apri e Salva con nome sia in stile precedente.

È possibile fornire filtri per i nomi di file per consentire all'utente di limitare i nomi di file visualizzati nella finestra di dialogo. Un filtro di nome file è costituito da una coppia di stringhe con terminazione Null, una descrizione e un criterio, una concatenata all'altra. Nella finestra di dialogo viene visualizzata la descrizione per consentire all'utente di selezionare il filtro da usare; e usa il modello per selezionare i file da visualizzare.

Per specificare i filtri, impostare il membro lpstrFilter della struttura OPENFILENAME in modo che punti a un buffer contenente una matrice di coppie di stringhe di filtro. L'ultima stringa nella matrice deve essere seguita da un carattere Null aggiuntivo.

Una stringa di modello può essere una combinazione di caratteri di nome file validi e l'asterisco (*). L'asterisco è un carattere jolly che rappresenta qualsiasi combinazione di caratteri di nome file validi. Nella finestra di dialogo vengono visualizzati solo i file che corrispondono al modello. Per specificare più modelli per la stessa descrizione, è necessario usare un punto e virgola (;) per separare i modelli. Si noti che i caratteri di spazio nella stringa del criterio possono produrre risultati imprevisti.

Il frammento di codice seguente specifica due filtri. Il filtro con la descrizione "Source" ha due modelli. Se l'utente seleziona questo filtro, nella finestra di dialogo vengono visualizzati solo i file con . C e . Estensioni CXX. Si noti che nel linguaggio di programmazione C una stringa racchiusa tra virgolette doppie è con terminazione Null.

OPENFILENAME ofn;       // common dialog box structure

ofn.lpstrFilter = "Source\0*.C;*.CXX\0All\0*.*\0"
ofn.nFilterIndex = 1;

Il membro nFilterIndex della struttura OPENFILENAME specifica un indice che indica quale filtro viene utilizzato inizialmente dalla finestra di dialogo. Il primo filtro nel buffer ha indice 1, il secondo 2 e così via. Se l'utente modifica il filtro durante l'utilizzo della finestra di dialogo, il membro nFilterIndex viene impostato sull'indice del filtro selezionato al ritorno.

È possibile creare un filtro personalizzato impostando il membro lpstrCustomFilter sull'indirizzo di un buffer che contiene un singolo filtro e impostando il membro nMaxCustFilter sulle dimensioni del buffer, in caratteri o byte. La finestra di dialogo inserisce sempre il filtro personalizzato all'inizio dell'elenco dei filtri e, in caso di restituzione, aggiorna sempre la parte del criterio del filtro con il criterio dal filtro selezionato dall'utente.

Per le finestre di dialogo in stile Esplora risorse, l'estensione predefinita può cambiare se l'utente seleziona un filtro diverso. Se l'utente seleziona un filtro il cui primo modello è nel formato *. xxx (ovvero l'estensione non include un carattere jolly), la finestra di dialogo usa xxx come estensione predefinita. Ciò si verifica solo se è stata specificata un'estensione predefinita nel membro lpstrDefExt della struttura OPENFILENAME . Ad esempio, se l'utente seleziona "Source\0*. C;*. Filtro CXX\0, l'estensione predefinita cambia in "C". Tuttavia, se il filtro è stato definito come "Source\0*. C*\0", l'estensione predefinita non cambia perché l'estensione include un carattere jolly.

Il messaggio di notifica CDN_INCLUDEITEM consente di filtrare i nomi visualizzati nella finestra di dialogo. Per usare questo messaggio, specificare una routine hook OFNHookProc e specificare il flag OFN_ENABLEINCLUDENOTIFY nella struttura OPENFILENAME quando si crea la finestra di dialogo. Ogni volta che l'utente apre una cartella, la finestra di dialogo invia una notifica CDN_INCLUDEITEM alla procedura hook per ogni elemento nella cartella appena aperta. Il valore restituito della routine hook indica se la finestra di dialogo deve visualizzare l'elemento nell'elenco di elementi della cartella.

Convalida di file e directory

Ad eccezione di quanto indicato, le informazioni contenute in questa sezione si applicano alle finestre di dialogo Apri e Salva con nome in stile precedente.

La finestra di dialogo convalida automaticamente i nomi di file digitati dall'utente per assicurarsi che i nomi contengano solo caratteri validi. Per eseguire l'override della convalida dei caratteri del nome file, impostare il flag OFN_NOVALIDATE .

Per forzare la finestra di dialogo per verificare che l'utente ha specificato il nome di un file esistente, impostare il flag di OFN_FILEMUSTEXIST . Per forzare la verifica dell'esistenza del percorso specificato, impostare il flag OFN_PATHMUSTEXIST . Se si imposta il flag di OFN_CREATEPROMPT , la finestra di dialogo richiede all'utente l'autorizzazione per creare un file inesistente. Se questo flag è impostato e l'utente sceglie di creare un nuovo file, la finestra di dialogo viene chiusa e la funzione restituisce il nome specificato. In caso contrario, la finestra di dialogo rimane aperta.

Quando si usa la finestra di dialogo Salva con nome, è possibile indirizzare la finestra di dialogo per richiedere all'utente l'autorizzazione per sovrascrivere un file esistente impostando il flag OFN_OVERWRITEPROMPT .

Per impostazione predefinita, la finestra di dialogo crea un file di test di lunghezza zero per determinare se è possibile creare un nuovo file nella directory selezionata. Per impedire la creazione di questo file di test, impostare il flag OFN_NOTESTFILECREATE .

Se si abilita una procedura hook, la finestra di dialogo invia una notifica alla routine hook quando si verifica una violazione di condivisione di rete per il nome file specificato dall'utente. Se si imposta il flag di OFN_EXPLORER , la finestra di dialogo invia il messaggio CDN_SHAREVIOLATION alla routine hook. Se non si imposta OFN_EXPLORER, la finestra di dialogo invia il messaggio registrato SHAREVISTRING alla procedura di hook. Per impedire alla finestra di dialogo di inviare notifiche per le violazioni di condivisione, impostare il flag di OFN_SHAREAWARE .

Se l'utente seleziona la casella di controllo di sola lettura, la finestra di dialogo imposta il flag di OFN_READONLY restituito. Per nascondere la casella di controllo Apri come sola lettura, impostare il flag di OFN_HIDEREADONLY . Per impedire alla finestra di dialogo di restituire nomi di file esistenti con l'attributo di sola lettura, impostare il flag di OFN_NOREADONLYRETURN .

Per evitare che la finestra di dialogo dereferenzii i file di collegamento, impostare il valore OFN_NODEREFERENCELINKS . In questo caso, la finestra di dialogo restituisce il nome del file di collegamento anziché il nome del file a cui fa riferimento il file di collegamento.

Personalizzazione della finestra di dialogo Apri e salva con nome

È possibile personalizzare una finestra di dialogo Apri o Salva con nome specificando una routine hook, un modello personalizzato o entrambi. Tuttavia, le versioni di Explorer e old-style delle finestre di dialogo differiscono per l'uso di modelli personalizzati e procedure hook.

Per informazioni sulla personalizzazione di una finestra di dialogo in stile Esplora risorse, vedere Procedure hook in stile Explorer, Modelli personalizzati in stile Esplora e Identificatori di controllo in stile Esplora risorse. Per informazioni sulla personalizzazione di una finestra di dialogo di tipo obsoleto, vedere Personalizzazione delle finestre di dialogo Old-Style.

Nella tabella seguente vengono riepilogate le differenze tra i due stili.

Il titolo predefinito per entrambe le finestre di dialogo di tipo Explorer e old-style è "Apri" o "Salva con nome". Per modificare il titolo, specificare il nuovo titolo nel membro lpstrTitle della struttura OPENFILENAME .

L'hive del Registro di sistema di HKEY_CURRENT_USER di un utente può contenere valori che personalizzano il contenuto delle finestre di dialogo Apri e Salva con nome in stile Esplora risorse. Queste voci del Registro di sistema influiscono solo sulle finestre di dialogo visualizzate per l'utente associato all'hive del Registro di sistema.

Per nascondere le funzionalità delle finestre di dialogo Apri e Salva con nome in stile Esplora risorse, un amministratore può impostare i valori nella tabella seguente sotto questa sottochiave:

HKEY_CURRENT_USER
   Software
      Microsoft
         Windows
            CurrentVersion
               Policies
                  Comdlg32

Il contenuto della barra Dei luoghi è determinato dal contenuto della sottochiave seguente:

HKEY_CURRENT_USER
   Software
      Microsoft
         Windows
            CurrentVersion
               Policies
                  Comdlg32
                     Placesbar

Attualmente, in questa chiave possono essere presenti solo cinque voci e l'indice valore/nome è in base zero. I nomi delle voci devono essere Place0, Place1, Place2,Place3 e Place4. I valori delle voci possono essere REG_DWORD, REG_SZ o REG_EXPAND_SZ valori che identificano le posizioni da includere nella barra delle posizioni.

procedure hook Explorer-Style

È possibile personalizzare una finestra di dialogo Apri o Salva con nome in stile Esplora risorse specificando una routine hook, un modello personalizzato o entrambi. Se si specifica una procedura hook per una finestra di dialogo di tipo Explorer, il sistema crea una finestra di dialogo figlio della finestra di dialogo predefinita. La procedura hook funge da procedura di dialogo per la finestra di dialogo figlio. Questa finestra di dialogo figlio è basata sul modello personalizzato o su un modello predefinito se non viene specificato nessuno. Per altre informazioni, vedere Modelli personalizzati in stile Esplora risorse.

Per abilitare una routine hook per una finestra di dialogo Apri o Salva con nome in stile Esplora risorse, utilizzare la struttura OPENFILENAME quando si crea la finestra di dialogo. Impostare i flag OFN_ENABLEHOOK e OFN_EXPLORER nel membro Flags e specificare l'indirizzo di una routine hook OFNHookProc nel membro lpfnHook . Se si specifica una routine hook e si omette il flag di OFN_EXPLORER , è necessario usare una routine hook OFNHookProcOldStyle e si otterrà l'interfaccia utente di stile precedente. Per altre informazioni, vedere Personalizzazione delle finestre di dialogo Old-Style.

Una routine hook di tipo Explorer riceve un'ampia gamma di messaggi mentre la finestra di dialogo è aperta. tra cui:

• Messaggio di WM_INITDIALOG e altri messaggi di finestra di dialogo standard, ad esempio il messaggio di colore del controllo WM_CTLCOLORDLG .
• Set di messaggi di notifica di WM_NOTIFY che indicano le azioni eseguite dall'utente o da altri eventi della finestra di dialogo.
• Messaggi per eventuali controlli aggiuntivi definiti specificando un modello di finestra di dialogo figlio.

È inoltre disponibile un set di messaggi che è possibile inviare a una finestra di dialogo in stile Explorer per ottenere informazioni o per controllare il comportamento e l'aspetto della finestra di dialogo.

Se si specifica una routine hook per una finestra di dialogo in stile Esplora risorse, la procedura predefinita della finestra di dialogo crea una finestra di dialogo figlio quando la routine di dialogo predefinita elabora il messaggio WM_INITDIALOG . La procedura hook funge da procedura di dialogo per la finestra di dialogo figlio. Al momento, la routine hook riceve il proprio messaggio WM_INITDIALOG con il parametro lParam impostato sull'indirizzo della struttura OPENFILENAME utilizzata per inizializzare la finestra di dialogo. Al termine dell'elaborazione del messaggio WM_INITDIALOG del dialogo figlio, la routine di dialogo predefinita sposta i controlli standard, se necessario, per liberare spazio per eventuali controlli aggiuntivi della finestra di dialogo figlio. La procedura di dialogo predefinita invia quindi il messaggio di notifica CDN_INITDONE alla procedura di hook.

La procedura hook riceve WM_NOTIFY messaggi di notifica che indicano le azioni eseguite dall'utente nella finestra di dialogo. È possibile utilizzare alcuni di questi messaggi per controllare il comportamento della finestra di dialogo. Ad esempio, la procedura hook riceve il messaggio CDN_FILEOK quando l'utente sceglie un nome file e fa clic sul pulsante OK . In risposta a questo messaggio, la routine hook può usare la funzione SetWindowLong per rifiutare il nome selezionato e forzare la finestra di dialogo a rimanere aperta.

Il parametro lParam per ogni WM_NOTIFY messaggio è un puntatore a una struttura OFNOTIFY o OFNOTIFYEX che definisce l'azione. Il membro di codice nell'intestazione di questa struttura contiene uno dei messaggi di notifica seguenti.

Questi messaggi WM_NOTIFY sostituiscono i messaggi registrati FILEOKSTRING, LBSELCHSTRING, SHAREVISTRING e HELPMSGSTRING usati dalle versioni precedenti delle finestre di dialogo Apri e Salva con nome. Tuttavia, la routine hook riceve anche il messaggio sostituito dopo il messaggio WM_NOTIFY se l'elaborazione WM_NOTIFY non usa SetWindowLong per impostare un valore diverso da zero DWL_MSGRESULT .

Per recuperare informazioni sullo stato della finestra di dialogo o per controllare il comportamento e l'aspetto della finestra di dialogo, la routine hook può inviare i messaggi seguenti alla finestra di dialogo.

Explorer-Style modelli personalizzati

Per definire controlli aggiuntivi per una finestra di dialogo Apri o Salva con nome in stile Esplora risorse, utilizzare la struttura OPENFILENAME per specificare un modello per una finestra di dialogo figlio contenente i controlli aggiuntivi. Se il modello di dialogo figlio è una risorsa in un'applicazione o in una libreria a collegamento dinamico, impostare il flag OFN_ENABLETEMPLATE nel membro Flags e usare i membri hInstance e lpTemplateName della struttura per identificare il modulo e il nome della risorsa. Se il modello è già in memoria, impostare il flag OFN_ENABLETEMPLATEHANDLE e usare il membro hInstance per identificare l'oggetto memoria che contiene il modello. Quando si specifica un modello di finestra di dialogo figlio per una finestra di dialogo in stile Explorer, è necessario impostare anche il flag di OFN_EXPLORER ; in caso contrario, il sistema presuppone che venga fornito un modello sostitutivo per una finestra di dialogo di vecchio stile. In genere, se si forniscono controlli aggiuntivi, è necessario fornire anche una routine hook di tipo Explorer per elaborare i messaggi per i nuovi controlli.

È possibile creare il modello di finestra di dialogo figlio come qualsiasi altro modello, ad eccezione del fatto che è necessario specificare gli stili di WS_CHILD e WS_CLIPSIBLINGS e specificare gli stili DS_3DLOOK e DS_CONTROL . Il sistema richiede lo stile WS_CHILD perché il modello definisce una finestra di dialogo figlio della finestra di dialogo predefinita Apri o Salva con nome. Lo stile WS_CLIPSIBLINGS garantisce che la finestra di dialogo figlio non eseghi alcun controllo nella finestra di dialogo predefinita. Lo stile DS_3DLOOK assicura che l'aspetto dei controlli nella finestra di dialogo figlio sia coerente con i controlli nella finestra di dialogo predefinita. Lo stile DS_CONTROL assicura che l'utente possa usare TAB e altri tasti di spostamento per spostarsi tra tutti i controlli, predefiniti o personalizzati, nella finestra di dialogo personalizzata.

Per fare spazio ai nuovi controlli, il sistema espande la finestra di dialogo predefinita in base alla larghezza e all'altezza della finestra di dialogo personalizzata. Per impostazione predefinita, tutti i controlli della finestra di dialogo personalizzata vengono posizionati sotto i controlli nella finestra di dialogo predefinita. È tuttavia possibile eseguire l'override di questo posizionamento predefinito includendo un controllo testo statico nel modello della finestra di dialogo personalizzata e assegnando il valore dell'identificatore di controllo stc32. Questo valore è definito nel file di intestazione Dlgs.h. In questo caso, il sistema usa il controllo come punto di riferimento per determinare dove posizionare i nuovi controlli. Tutti i nuovi controlli sopra e a sinistra del controllo stc32 vengono posizionati la stessa quantità sopra e a sinistra dei controlli nella finestra di dialogo predefinita. I nuovi controlli seguenti e a destra del controllo stc32 sono posizionati sotto e a destra dei controlli predefiniti. In generale, ogni nuovo controllo viene posizionato in modo che abbia la stessa posizione rispetto ai controlli predefiniti rispetto al controllo stc32 . Per fare spazio a questi nuovi controlli, il sistema aggiunge spazio a sinistra, destra, inferiore e superiore della finestra di dialogo predefinita in base alle esigenze.

Il sistema richiede la routine hook per elaborare tutti i messaggi destinati alla finestra di dialogo personalizzata e quindi invia gli stessi messaggi di finestra alla routine hook come a qualsiasi altra procedura di finestra di dialogo. Ad esempio, la procedura hook riceve WM_COMMAND messaggi quando l'utente fa clic sui controlli pulsante nella finestra di dialogo personalizzata. La routine hook è responsabile dell'inizializzazione di questi controlli e del recupero di valori dai controlli quando la finestra di dialogo viene chiusa. Si noti che quando la routine hook riceve il messaggio WM_INITDIALOG , il sistema non ha ancora spostato i controlli nelle rispettive posizioni finali.

La procedura predefinita della finestra di dialogo gestisce i messaggi per tutti i controlli nella finestra di dialogo predefinita, ma la routine hook riceve i messaggi di notifica per le azioni utente su questi controlli, come descritto in Procedure hook in stile Explorer.

Identificatori di controllo Explorer-Style

Windows Software Development Kit (SDK) fornisce il modello di finestra di dialogo predefinito per le finestre di dialogo in stile precedente, ma non include il modello predefinito per le finestre di dialogo in stile Explorer. Ciò è dovuto al fatto che le finestre di dialogo in stile Explorer consentono di aggiungere controlli personalizzati, ma non supportano la modifica del modello per i controlli standard. In alcuni casi, tuttavia, potrebbe essere necessario conoscere gli identificatori di controllo usati nei modelli predefiniti. Ad esempio, i messaggi CDM_HIDECONTROL e CDM_SETCONTROLTEXT richiedono un identificatore di controllo.

Nella tabella seguente vengono illustrati gli identificatori dei controlli standard nelle finestre di dialogo Apri e Salva con nome in stile Esplora risorse. Gli identificatori sono costanti definite in Dlgs.h e Winuser.h.

Personalizzazione delle finestre di dialogo Old-Style

È possibile personalizzare una finestra di dialogo Apri o Salva con nome precedente specificando una routine hook OFNHookProcOldStyle che riceve messaggi o notifiche destinati alla procedura predefinita della finestra di dialogo. È anche possibile specificare un modello personalizzato da usare al posto del modello predefinito. Le procedure hook e i modelli usati con le finestre di dialogo in stile precedente sono simili a quelli usati con le altre finestre di dialogo comuni. Per altre informazioni, vedere Procedure hook per finestre di dialogo comuni e modelli personalizzati.

Per abilitare una routine hook per una finestra di dialogo Apri o Salva con nome precedente, utilizzare la struttura OPENFILENAME quando si crea la finestra di dialogo. Impostare il flag OFN_ENABLEHOOK nel membro Flags e specificare l'indirizzo di una routine hook OFNHookProcOldStyle nel membro lpfnHook . La procedura della finestra di dialogo invia un messaggio WM_INITDIALOG alla routine di hook con il parametro Param impostato sull'indirizzo della struttura OPENFILENAME utilizzata per inizializzare la finestra di dialogo.

È possibile utilizzare la struttura OPENFILENAME per specificare un modello personalizzato per la finestra di dialogo Apri o Salva con nome da utilizzare al posto del modello predefinito. Se il modello personalizzato è una risorsa in un'applicazione o in una libreria a collegamento dinamico, impostare il flag OFN_ENABLETEMPLATE nel membro Flags e usare i membri hInstance e lpTemplateName della struttura per identificare il modulo e il nome della risorsa. Se il modello personalizzato è già in memoria, impostare il flag OFN_ENABLETEMPLATEHANDLE e usare il membro hInstance per identificare l'oggetto memoria che contiene il modello. Creare il modello personalizzato modificando il modello predefinito specificato nel file Fileopen.dlg. Gli identificatori di controllo usati nei modelli di finestra di dialogo Trova e sostituisci predefiniti sono definiti nel file Dlgs.h.

Per impostazione predefinita, le funzioni GetOpenFileName e GetSaveFileName visualizzano le finestre di dialogo in stile Explorer. Se si desidera visualizzare una finestra di dialogo in stile precedente, è necessario fornire una routine hook OFNHookProcOldStyle e assicurarsi che il flag di OFN_EXPLORER non sia impostato nel membro Flags della struttura OPENFILENAME .

Se si imposta il flag di OFN_EXPLORER , il sistema considera una routine hook o un modello personalizzato come personalizzazione in stile Explorer. Per informazioni sulla personalizzazione di una finestra di dialogo in stile Esplora risorse, vedere Modelli personalizzati in stile Esplora risorse.

Vedi anche

• Il file è in uso