Tipi di finestre di dialogo comuni

La libreria delle finestre di dialogo comuni fornisce una funzione di creazione e una struttura per ogni tipo di finestra di dialogo comune. Per usare una finestra di dialogo comune nel formato più semplice, chiamare la relativa funzione di creazione e specificare un puntatore a una struttura che contiene valori iniziali e flag di opzione. Dopo l'inizializzazione della finestra di dialogo, la routine della finestra di dialogo utilizza la struttura per restituire informazioni sull'input dell'utente. È anche possibile personalizzare una finestra di dialogo comune in base alle esigenze dell'applicazione.

La tabella seguente fornisce una breve descrizione dei diversi tipi di finestre di dialogo comuni e mostra la funzione e la struttura utilizzata con ogni tipo.

Finestra di dialogo	Descrizione
Color	Visualizza i colori disponibili e facoltativamente consente all'utente di creare colori personalizzati. L'utente può selezionare un colore di base o personalizzato. Utilizzare la funzione ChooseColor e la struttura CHOOSECOLOR . Per altre informazioni, vedere Finestra di dialogo Colore.
Find	Visualizza una finestra di dialogo in cui l'utente può digitare la stringa da trovare. L'utente può anche specificare opzioni di ricerca, ad esempio la direzione di ricerca e se la ricerca fa distinzione tra maiuscole e minuscole. Utilizzare la funzione FindText e la struttura FINDREPLACE . Per altre informazioni, vedere Trovare e sostituire le finestre di dialogo.
Carattere	Visualizza una finestra di dialogo in cui l'utente può selezionare una famiglia di caratteri e uno stile di carattere associato, dimensioni dei punti e altri attributi del tipo di carattere, ad esempio colore del carattere, sottolineatura o barrato. Usare la funzione ChooseFont e la struttura CHOOSEFONT . Per altre informazioni, vedere Finestra di dialogo Tipo di carattere.
Apri	Visualizza una finestra di dialogo in cui l'utente può digitare o selezionare il nome di un file o di un oggetto spazio dei nomi della shell da aprire. La finestra di dialogo include elenchi di unità, directory ed estensioni dello spazio dei nomi della shell che consentono all'utente di esplorare lo spazio dei nomi della shell. Include anche un elenco di estensioni di file che consentono all'utente di filtrare i nomi di file visualizzati. Utilizzare la funzione GetOpenFileName e la struttura OPENFILENAME . Per altre informazioni, vedere Finestre di dialogo Apri e Salva con nome.
Imposta pagina	Visualizza la configurazione della pagina corrente. L'utente può selezionare le opzioni di configurazione della pagina, ad esempio orientamento della carta, dimensioni, origine e margini. Utilizzare la funzione PageSetupDlg e la struttura PAGESETUPDLG . Per altre informazioni, vedere Finestra di dialogo Imposta pagina.
Stampa	Visualizza informazioni sulla stampante installata e sulla relativa configurazione. L'utente può selezionare le opzioni del processo di stampa, ad esempio l'intervallo di pagine da stampare e il numero di copie e avviare il processo di stampa. Utilizzare la funzione PrintDlg e la struttura PRINTDLG . Per altre informazioni, vedere Finestra di dialogo Stampa. Per visualizzare una finestra delle proprietà Print anziché una finestra di dialogo Stampa , utilizzare la funzione PrintDlgEx con la struttura PRINTDLGEX . La pagina Generale della finestra delle proprietà è simile alla finestra di dialogo Stampa . La finestra delle proprietà può avere pagine delle proprietà aggiuntive specifiche dell'applicazione e specifiche del driver dopo la pagina Generale . Per altre informazioni, vedere Stampare la finestra delle proprietà.
Replace	Visualizza una finestra di dialogo in cui l'utente può digitare la stringa da trovare e la stringa di sostituzione. L'utente può specificare opzioni di ricerca, ad esempio se la ricerca fa distinzione tra maiuscole e minuscole e opzioni di sostituzione, ad esempio l'ambito della sostituzione. Utilizzare la funzione ReplaceText e la struttura FINDREPLACE . Per altre informazioni, vedere Trovare e sostituire le finestre di dialogo.
Save As	Visualizza una finestra di dialogo in cui l'utente può digitare o selezionare il nome con cui salvare un file o un oggetto spazio dei nomi della shell. La finestra di dialogo include elenchi di unità, directory ed estensioni dello spazio dei nomi della shell che consentono all'utente di esplorare lo spazio dei nomi della shell. Include anche un elenco di estensioni di file che consentono all'utente di filtrare i nomi di file visualizzati. Usare la funzione GetSaveFileName e la struttura OPENFILENAME . Per altre informazioni, vedere Finestre di dialogo Apri e Salva con nome.

Anche se è disponibile una finestra di dialogo Imposta stampa , è stata sostituita dalla finestra di dialogo Imposta pagina . Le applicazioni devono utilizzare la finestra di dialogo Imposta pagina anziché la finestra di dialogo Imposta stampante .

Tutte le finestre di dialogo comuni sono modali, ad eccezione delle finestre di dialogo Trova e Sostituisci . Le finestre di dialogo modali devono essere chiuse dall'utente prima che la funzione utilizzata per creare la finestra di dialogo possa restituire. Le finestre di dialogo Trova e sostituisci sono senza modalità; la funzione viene restituita prima della chiusura della finestra di dialogo. Se si usano le finestre di dialogo Trova e sostituisci , è necessario utilizzare anche la funzione IsDialogMessage nel ciclo di messaggi principale dell'applicazione per assicurarsi che queste finestre di dialogo elaborino correttamente l'input della tastiera, ad esempio i tasti TAB e ESC.