Libreria delle finestre di dialogo comuni

Common Dialog Box Library contiene un set di finestre di dialogo per l'esecuzione di attività comuni dell'applicazione, ad esempio l'apertura di file, la scelta dei valori di colore e la stampa di documenti. Le finestre di dialogo comuni consentono di implementare un approccio coerente all'interfaccia utente dell'applicazione. In questo modo si riduce la quantità di impegno che gli utenti dedicano al comportamento dell'interfaccia utente per l'applicazione.

In questa sezione vengono descritte le finestre di dialogo comuni che includono le finestre di dialogo Apri e Salva con nome; le finestre di dialogo Trova e sostituisci modifica; le finestre di dialogo Stampa, Imposta stampa, Foglio proprietà stampa e Imposta pagina; e le finestre di dialogo Colore e Carattere .

Nota

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.

Contenuto della sezione

Nome	Descrizione
Tipi di finestre di dialogo comuni	Vengono illustrate le diverse finestre di dialogo.
Flag di inizializzazione delle finestre di dialogo comuni	Viene illustrato come vengono usati i flag per modificare il comportamento e l'aspetto di una finestra di dialogo comune.
Personalizzazione delle finestre di dialogo comuni	Viene illustrato come usare le finestre di dialogo comuni.
Uso delle finestre di dialogo comuni	Vengono illustrate le attività che richiamano finestre di dialogo comuni.
Informazioni di riferimento sulle finestre di dialogo comuni	Contiene il riferimento all'API.

Funzioni

Nome	Descrizione
CCHookProc	Riceve messaggi o notifiche destinati alla procedura predefinita della finestra di dialogo Colore . Si tratta di una funzione di callback definita dall'applicazione o definita dalla libreria usata con la funzione ChooseColor .
CFHookProc	Riceve messaggi o notifiche destinati alla procedura predefinita della finestra di dialogo Tipo di carattere. Si tratta di una routine di callback definita dall'applicazione o definita dalla libreria usata con la funzione ChooseFont .
ChooseColor	Crea una finestra di dialogo Colore che consente all'utente di selezionare un colore.
ScegliFont	Crea una finestra di dialogo Tipo di carattere che consente all'utente di scegliere gli attributi per un tipo di carattere logico. Questi attributi includono una famiglia di caratteri e uno stile di carattere associato, una dimensione punto, effetti (sottolineatura, barrato e colore del testo) e uno script (o set di caratteri).
CommDlgExtendedError	Restituisce un codice di errore comune della finestra di dialogo. Questo codice indica l'errore più recente che si verifica durante l'esecuzione di una delle funzioni comuni della finestra di dialogo.
Findtext	Crea una finestra di dialogo Trova senza modalità definita dal sistema che consente all'utente di specificare una stringa da cercare e le opzioni da utilizzare durante la ricerca di testo in un documento.
FRHookProc	Riceve messaggi o notifiche destinati alla procedura predefinita della finestra di dialogo Trova o Sostituisci . Si tratta di una funzione di callback definita dall'applicazione o definita dalla libreria usata con la funzione FindText o ReplaceText .
GetFileTitle	Recupera il nome del file specificato.
Getopenfilename	Crea una 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.
GetSaveFileName	Crea una finestra di dialogo Salva che consente all'utente di specificare l'unità, la directory e il nome di un file da salvare.
OFNHookProc	Riceve i messaggi di notifica inviati dalla finestra di dialogo. La funzione riceve anche messaggi per tutti i controlli aggiuntivi definiti specificando un modello di finestra di dialogo figlio. Si tratta di una funzione di callback definita dall'applicazione o definita dalla libreria usata con le finestre di dialogo Apri e Salva con nome in stile Esplora risorse.
OFNHookProcOldStyle	Riceve messaggi o notifiche destinati alla procedura della finestra di dialogo. Si tratta di una funzione di callback definita dall'applicazione o definita dalla libreria usata con le finestre di dialogo Apri e Salva con nome.
PagePaintHook	Riceve messaggi che consentono di personalizzare il disegno della pagina di esempio nella finestra di dialogo Imposta pagina . Si tratta di una funzione di callback definita dall'applicazione o definita dalla libreria usata con la funzione PageSetupDlg .
PageSetupDlg	Crea una finestra di dialogo Imposta pagina che consente all'utente di specificare gli attributi di una pagina stampata. Questi attributi includono le dimensioni e l'origine della carta, l'orientamento della pagina (verticale o orizzontale) e la larghezza dei margini della pagina.
PageSetupHook	Riceve messaggi o notifiche destinati alla finestra di dialogo predefinita della finestra di dialogo Imposta pagina . Si tratta di una funzione di callback definita dall'applicazione o definita dalla libreria usata con la funzionePageSetupDlg.
PrintDlg	Visualizza unafinestra di dialogo Stampa. La finestra di dialogo Stampa consente all'utente di specificare le proprietà di un determinato processo di stampa.
PrintDlgEx	Visualizza una finestra delle proprietà Print che consente all'utente di specificare le proprietà di un determinato processo di stampa. In una finestra delle proprietàStampaè presente una pagina Generale contenente controlli simili alla finestra di dialogo Stampa . La finestra delle proprietà può anche avere pagine delle proprietà aggiuntive specifiche dell'applicazione e specifiche del driver, nonché la pagina Generale .
PrintHookProc	Riceve messaggi o notifiche destinati alla finestra di dialogo predefinita della finestra di dialogo Stampa . Si tratta di una funzione di callback definita dall'applicazione o definita dalla libreria usata con la funzione PrintDlg .
ReplaceText	Crea una finestra di dialogo senza modalità definita dal sistema che consente all'utente di specificare una stringa da cercare e una stringa di sostituzione, nonché di opzioni per controllare le operazioni di ricerca e sostituzione.
SetupHookProc	Funzione di callback definita dall'applicazione o definita dalla libreria usata con la funzione PrintDlg . La procedura hook riceve messaggi o notifiche destinati alla procedura predefinita della finestra di dialogo Imposta stampante .

Interfacce

Nome	Descrizione
IPrintDialogCallback	Fornisce metodi che consentono a un'applicazione di ricevere notifiche e messaggi dalla funzione PrintDlgEx mentre viene visualizzato il Foglio proprietà stampa .
IPrintDialogServices	Fornisce metodi che consentono a un'applicazione di usare la funzione PrintDlgEx per recuperare informazioni sulla stampante attualmente selezionata.

Messaggi

Nome	Descrizione
CDM_GETFILEPATH	Recupera il percorso e il nome del file selezionato in una finestra di dialogo Apri o Salva con nome. La finestra di dialogo deve essere stata creata con il flag OFN_EXPLORER; in caso contrario, il messaggio ha esito negativo.
CDM_GETFOLDERIDLIST	Recupera l'indirizzo dell'elenco di identificatori di elemento corrispondente alla cartella in cui è attualmente aperta una finestra di dialogo Apri o Salva con nome. La finestra di dialogo deve essere stata creata con il flag OFN_EXPLORER ; in caso contrario, il messaggio ha esito negativo.
CDM_GETFOLDERPATH	Recupera il percorso della cartella o della directory attualmente aperta per una finestra di dialogo Apri o Salva con nome. La finestra di dialogo deve essere stata creata con il flag OFN_EXPLORER ; in caso contrario, il messaggio ha esito negativo.
CDM_GETSPEC	Recupera il nome del file (non incluso il percorso) del file attualmente selezionato in una finestra di dialogo Apri o Salva con nome. La finestra di dialogo deve essere stata creata con il flag OFN_EXPLORER ; in caso contrario, il messaggio ha esito negativo.
CDM_HIDECONTROL	Nasconde il controllo specificato in una finestra di dialogo Apri o Salva con nome in stile Explorer. La finestra di dialogo deve essere stata creata con il flag OFN_EXPLORER ; in caso contrario, il messaggio ha esito negativo.
CDM_SETCONTROLTEXT	Imposta il testo per il controllo specificato in una finestra di dialogo Apri o Salva con nome di esplorazione. La finestra di dialogo deve essere stata creata con il flag OFN_EXPLORER ; in caso contrario, il messaggio ha esito negativo.
CDM_SETDEFEXT	Imposta l'estensione del nome file predefinita per una finestra di dialogo Apri o Salva con nome. La finestra di dialogo deve essere stata creata con il flag OFN_EXPLORER ; in caso contrario, il messaggio ha esito negativo.
SETRGBSTRING	La procedura di collegamento di una finestra di dialogo Color , CCHookProc, può inviare il messaggio registrato SETRGBSTRING alla finestra di dialogo per impostare la selezione dei colori corrente.
WM_CHOOSEFONT_GETLOGFONT	Un'applicazione invia il messaggio WM_CHOOSEFONT_GETLOGFONT a una finestra di dialogo Tipo di carattere per recuperare informazioni sulle selezioni dei tipi di carattere correnti dell'utente.
WM_CHOOSEFONT_SETFLAGS	Un'applicazione invia il messaggio WM_CHOOSEFONT_SETFLAGS a una finestra di dialogo Tipo di carattere per impostare le opzioni di visualizzazione per la finestra di dialogo.
WM_CHOOSEFONT_SETLOGFONT	Un'applicazione invia il messaggio WM_CHOOSEFONT_SETLOGFONT a una finestra di dialogo Tipo di carattere per impostare le informazioni correnti sul tipo di carattere logico corrente.

Notifiche

Nome	Descrizione
CDN_FILEOK	Inviato da una finestra di dialogo Apri o Salva con nome quando l'utente specifica un nome file e fa clic sul pulsante OK .
CDN_FOLDERCHANGE	Inviato da una finestra di dialogo Apri oSalva con nome quando viene aperta una nuova cartella.
CDN_HELP	Inviato da una finestra di dialogo Apri oSalva con nome quando l'utente fa clic sul pulsante Guida .
CDN_INCLUDEITEM	Inviato da una finestra di dialogo Apri o Salva con nome per determinare se la finestra di dialogo deve visualizzare un elemento nell'elenco di elementi di una shell. Quando l'utente apre una cartella, la finestra di dialogo invia una notifica CDN_INCLUDEITEM per ogni elemento della cartella. La finestra di dialogo invia questa notifica solo se il flag di OFN_ENABLEINCLUDENOTIFY è stato impostato quando è stata creata la finestra di dialogo.
CDN_INITDONE	Inviato da una finestra di dialogo Apri o Salva con nome quando il sistema ha completato la disposizione dei controlli nella finestra di dialogo. Il sistema sposta i controlli standard per rendere disponibili i controlli della finestra di dialogo figlio.
CDN_SELCHANGE	Inviato da una finestra di dialogo Apri o Salva con nome quando la selezione cambia nella casella di riepilogo che visualizza il contenuto della cartella o della directory attualmente aperta.
CDN_SHAREVIOLATION	Inviato da una finestra di dialogo Apri o Salva con nome quando l'utente fa clic sul pulsante OK e si verifica una violazione della condivisione di rete per il file selezionato.
CDN_TYPECHANGE	Inviato da una finestra di dialogo Apri oSalva con nome quando l'utente seleziona un nuovo tipo di file dalla casella combinata tipi di file.
COLOROKSTRING	Una finestra di dialogo Color invia il messaggio registrato COLOROKSTRING alla procedura di hook, CCHookProc, quando l'utente seleziona un colore e fa clic sul pulsante OK . La procedura hook può accettare il colore e consentire alla finestra di dialogo di chiudere o rifiutare il colore e forzare che la finestra di dialogo rimanga aperta.
FILEOKSTRING	Una finestra di dialogo Apri o Salva con nome invia il messaggio registrato FILEOKSTRING alla procedura di hook, OFNHookProc, quando l'utente specifica un nome file e fa clic sul pulsante OK . La procedura di hook può accettare il nome del file e consentire alla finestra di dialogo di chiudere o rifiutare il nome del file e forzare la finestra di dialogo a rimanere aperta.
FINDMSGSTRING	Una finestra di dialogo Trova o Sostituisci invia il messaggio registrato FINDMSGSTRING alla procedura di finestra del proprietario quando l'utente fa clic sul pulsante Trova avanti,sostituisci o sostituisci o chiude la finestra di dialogo.
HELPMSGSTRING	Una finestra di dialogo comune invia il messaggio registrato HELPMSGSTRING alla procedura della finestra del proprietario quando l'utente fa clic sul pulsante Guida .
LBSELCHSTRING	Una finestra di dialogo Apri o Salva con nome invia il messaggio registrato LBSELCHSTRING alla procedura di hook quando la selezione cambia in una delle caselle di riepilogo o nelle caselle combinate della finestra di dialogo.
SHAREVISTRING	Una finestra di dialogo Apri o Salva con nome invia il messaggio registrato SHAREVISTRING alla procedura di hook, OFNHookProc, se si verifica una violazione di condivisione per il file selezionato quando l'utente fa clic sul pulsante OK .
WM_PSD_ENVSTAMPRECT	Notifica alla procedura di collegamento di una finestra di dialogo Imposta pagina, PagePaintHook, che la finestra di dialogo sta per disegnare il rettangolo di busta della pagina di esempio.
WM_PSD_FULLPAGERECT	Notifica una routine di hook PagePaintHook delle coordinate del rettangolo di pagina di esempio nella finestra di dialogo Imposta pagina . La finestra di dialogo invia questo messaggio quando sta per disegnare il contenuto della pagina di esempio.
WM_PSD_GREEKTEXTRECT	Notifica alla procedura di collegamento di una finestra di dialogo Imposta pagina, PagePaintHook, che la finestra di dialogo sta per disegnare testo greco all'interno del rettangolo di margine della pagina di esempio.
WM_PSD_MARGINRECT	Notifica alla procedura di collegamento di una finestra di dialogo Imposta pagina, PagePaintHook, che la finestra di dialogo sta per disegnare il rettangolo di margine della pagina di esempio.
WM_PSD_MINMARGINRECT	Notifica una routine di hook PagePaintHook delle coordinate del rettangolo di margine nella pagina di esempio. Una finestra di dialogo Imposta pagina invia questo messaggio quando sta per disegnare il contenuto della pagina di esempio.
WM_PSD_PAGESETUPDLG	Notifica a una routine di hook PagePaintHook che la finestra di dialogo Imposta pagina sta per disegnare il contenuto della pagina di esempio. La procedura di hook può usare questo messaggio per eseguire attività di inizializzazione correlate al disegno del contenuto della pagina di esempio.
WM_PSD_YAFULLPAGERECT	Notifica alla procedura di collegamento di una finestra di dialogo Imposta pagina, PagePaintHook, che la finestra di dialogo sta per disegnare la parte dell'indirizzo restituito di una pagina di esempio della busta.

Strutture

Nome	Descrizione
CHOOSECOLOR	Contiene informazioni usate dalla funzione ChooseColor per inizializzare la finestra di dialogo Color . Dopo aver chiuso la finestra di dialogo, il sistema restituisce informazioni sulla selezione dell'utente in questa struttura.
CHOOSEFONT	Contiene informazioni usate dalla funzione ChooseFont per inizializzare la finestra di dialogo Carattere . Dopo aver chiuso la finestra di dialogo, il sistema restituisce informazioni sulla selezione dell'utente in questa struttura.
DEVNAMES	Contiene stringhe che identificano i nomi di porta driver, dispositivo e output per una stampante. Le funzioni PrintDlgEx e PrintDlg usano queste stringhe per inizializzare la finestra di dialogo Stampa definita dal sistema o Stampa. Quando l'utente chiude il foglio delle proprietà o la finestra di dialogo, le informazioni sulla stampante selezionata vengono restituite in questa struttura.
FINDREPLACE	Contiene informazioni usate dalle funzioni FindText e ReplaceText per inizializzare le finestre di dialogo Trova e Sostituisci . Il messaggio registrato FINDMSGSTRING usa questa struttura per passare l'input di ricerca o sostituzione dell'utente alla finestra proprietario di una finestra di dialogo Trova o Sostituisci .
OFNOTIFY	C contiene informazioni su un messaggio di WM_NOTIFY inviato a una procedura di hook OFNHookProc per una finestra di dialogo Apri o Salva con nome. Il parametro lParam del messaggio di WM_NOTIFY è un puntatore a una struttura OFNOTIFY .
OFNOTIFYEX	Contiene informazioni su un messaggio di notifica CDN_INCLUDEITEM .
OPENFILENAME	Contiene informazioni usate dalle funzioni GetOpenFileName e GetSaveFileName per inizializzare una finestra di dialogo Apri o Salva con nome. Dopo aver chiuso la finestra di dialogo, il sistema restituisce informazioni sulla selezione dell'utente in questa struttura.
OPENFILENAME_NT4	Identico a OPENFILENAME con _WIN32_WINNT impostato su 0x0400.
PAGESETUPDLG	Contiene informazioni usate dalla funzione PageSetupDlg per inizializzare la finestra di dialogo Imposta pagina . Dopo aver chiuso la finestra di dialogo, il sistema restituisce informazioni sui parametri di pagina definiti dall'utente in questa struttura.
PRINTDLG	Contiene informazioni usate dalla funzione PrintDlg per inizializzare la finestra di dialogo stampa. Dopo aver chiuso la finestra di dialogo, il sistema usa questa struttura per restituire informazioni sulle selezioni dell'utente.
PRINTDLGEX	Contiene informazioni usate dalla funzione PrintDlgEx per inizializzare il foglio delle proprietà Print. Dopo aver chiuso il foglio delle proprietà, il sistema usa questa struttura per restituire informazioni sulle selezioni dell'utente.
PRINTPAGERANGE	Specifica un intervallo di pagine in un processo di stampa. Un processo di stampa può avere più di un intervallo di pagine. Queste informazioni vengono fornite nella struttura PRINTDLGEX quando si chiama la funzione PrintDlgEx .