Libreria di 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 lavoro che gli utenti spendono nel comportamento dell'interfaccia utente di apprendimento per l'applicazione.
In questa sezione vengono descritte le finestre di dialogo comuni che includono le finestre di dialogo Apri e Salva come file, le finestre di dialogo Trova e sostituisci modifica, 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 Apri e Salva con nome sono state sostituite dalla finestra di dialogo Elemento comune. È consigliabile usare l'API Della finestra di dialogo elementi comuni anziché queste finestre di dialogo dalla libreria di finestre di dialogo comuni.
In questa sezione
| Nome | Descrizione |
|---|---|
| Tipi di finestre di dialogo comuni | Vengono illustrate le diverse finestre di dialogo. |
| Flag di inizializzazione della finestra 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 finestre di dialogo comuni. |
| Utilizzo di 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 utilizzata con la funzione ChooseFont . |
| ChooseColor | Crea una finestra di dialogo Colore che consente all'utente di selezionare un colore. |
| Scegli Carattere | 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, barratura 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 da verificare 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 inoltre 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 Explorer. |
| 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 procedura predefinita della finestra di dialogo Imposta pagina. Si tratta di una funzione di callback definita dall'applicazione o definita dalla libreria usata con lafunzione PageSetupDlg. |
| PrintDlg | Visualizza una finestra 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. Unafinestra delle proprietà Stampainclude una pagina Generale che contiene 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 procedura 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é 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 stampa. |
Interfacce
| Nome | Descrizione |
|---|---|
| IPrintDialogCallback | Fornisce metodi che consentono a un'applicazione di ricevere notifiche e messaggi dalla funzione PrintDlgEx durante la visualizzazione della finestra delle proprietà di stampa. |
| IPrintDialogServices | Fornisce metodi che consentono a un'applicazione di utilizzare la funzione PrintDlgEx per recuperare informazioni sulla stampante attualmente selezionata. |
Messaggi
| Nome | Descrizione |
|---|---|
| CDM_GETFILEPATH | Recupera il percorso e il nome file del file selezionato in una finestra di dialogo Apri o Salva con nome in stile Esplora risorse. 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 attualmente aperta in una finestra di dialogo Apri o Salva con nome in stile Esplora risorse. La finestra di dialogo deve essere stata creata con il flag OFN_EXPLORER ; in caso contrario, il messaggio non riesce. |
| CDM_GETFOLDERPATH | Recupera il percorso della cartella o della directory attualmente aperta per una finestra di dialogo Apri o Salva con nome in stile Esplora risorse. La finestra di dialogo deve essere stata creata con il flag OFN_EXPLORER ; in caso contrario, il messaggio non riesce. |
| 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 in stile Esplora risorse. La finestra di dialogo deve essere stata creata con il flag OFN_EXPLORER ; in caso contrario, il messaggio non riesce. |
| CDM_HIDECONTROL | Nasconde il controllo specificato in una finestra di dialogo Apri o Salva con nome in stile Esplora risorse. La finestra di dialogo deve essere stata creata con il flag OFN_EXPLORER ; in caso contrario, il messaggio non riesce. |
| CDM_SETCONTROLTEXT | Imposta il testo per il controllo specificato in una finestra di dialogo Apri o Salva con nome in stile Esplora risorse. La finestra di dialogo deve essere stata creata con il flag OFN_EXPLORER ; in caso contrario, il messaggio non riesce. |
| CDM_SETDEFEXT | Imposta l'estensione del nome file predefinita per una finestra di dialogo Apri o Salva con nome in stile Esplora risorse. La finestra di dialogo deve essere stata creata con il flag OFN_EXPLORER ; in caso contrario, il messaggio non riesce. |
| SETRGBSTRING | La procedura hook di una finestra di dialogo Colore, CCHookProc, può inviare il messaggio registrato SETRGBSTRING alla finestra di dialogo per impostare la selezione del colore corrente. |
| WM_CHOOSEFONT_GETLOGFONT | Un'applicazione invia il messaggio di WM_CHOOSEFONT_GETLOGFONT a una finestra di dialogo Tipo di carattere per recuperare informazioni sulle selezioni correnti del tipo di carattere 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 sul tipo di carattere logico correnti. |
Notifications
| Nome | Descrizione |
|---|---|
| CDN_FILEOK | Inviato da una finestra di dialogo Apri o Salva con nome in stile Explorer quando l'utente specifica un nome file e fa clic sul pulsante OK. |
| CDN_FOLDERCHANGE | Inviato da una finestra di dialogo Apri o Salva con nome in stile Explorer quando viene aperta una nuova cartella. |
| CDN_HELP | Inviato da una finestra di dialogo Apri o Salva con nome in stile Explorer quando l'utente fa clic sul pulsante ? |
| 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 cartella della shell. Quando l'utente apre una cartella, la finestra di dialogo invia una notifica di CDN_INCLUDEITEM per ogni elemento nella cartella. La finestra di dialogo invia questa notifica solo se il flag OFN_ENABLEINCLUDENOTIFY è stato impostato al momento della creazione della finestra di dialogo. |
| CDN_INITDONE | Inviato da una finestra di dialogo Apri o Salva con nome in stile Explorer al termine della disposizione dei controlli nella finestra di dialogo. Il sistema sposta i controlli standard per fare spazio ai controlli della finestra di dialogo figlio. |
| CDN_SELCHANGE | Inviato da una finestra di dialogo Apri o Salva con nome in stile Explorer 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 in stile Explorer quando l'utente fa clic sul pulsante OK e si verifica una violazione di condivisione di rete per il file selezionato. |
| CDN_TYPECHANGE | Inviato da una finestra di dialogo Apri o Salva con nome in stile Explorer quando l'utente seleziona un nuovo tipo di file dalla casella combinata Tipi di file. |
| COLOROKSTRING | Una finestra di dialogo Colore invia il messaggio registrato COLOROKSTRING alla procedura 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 la finestra di dialogo a rimanere aperta. |
| FILEOKSTRING | Una finestra di dialogo Apri o Salva con nome invia il messaggio registrato FILEOKSTRING alla procedura hook, OFNHookProc, quando l'utente specifica un nome file e fa clic sul pulsante OK. La procedura 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 successivo, Sostituisci o Sostituisci tutto oppure 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 ?. |
| LBSELCHSTRING | Una finestra di dialogo Apri o Salva con nome invia il messaggio registrato LBSELCHSTRING alla routine hook quando la selezione cambia in una delle caselle di riepilogo o delle caselle combinate della finestra di dialogo. |
| SHAREVISTRING | Una finestra di dialogo Apri o Salva con nome invia il messaggio registrato SHAREVISTRING alla procedura 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 hook di una finestra di dialogo Imposta pagina, PagePaintHook, che la finestra di dialogo sta per disegnare il rettangolo busta della pagina di esempio. |
| WM_PSD_FULLPAGERECT | Notifica a una routine hook PagePaintHook delle coordinate del rettangolo della 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 routine hook di una finestra di dialogo Imposta pagina, PagePaintHook, che la finestra di dialogo sta per disegnare testo greco all'interno del rettangolo margine della pagina di esempio. |
| WM_PSD_MARGINRECT | Notifica alla routine hook 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 a una routine hook PagePaintHook delle coordinate del rettangolo del 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 hook PagePaintHook che la finestra di dialogo Imposta pagina sta per disegnare il contenuto della pagina di esempio. La procedura hook può utilizzare questo messaggio per eseguire attività di inizializzazione correlate al disegno del contenuto della pagina di esempio. |
| WM_PSD_YAFULLPAGERECT | Notifica alla routine hook 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 utilizzate dalla funzione ChooseColor per inizializzare la finestra di dialogo Colore . Dopo che l'utente chiude la finestra di dialogo, il sistema restituisce informazioni sulla selezione dell'utente in questa struttura. |
| CHOOSEFONT | Contiene informazioni utilizzate dalla funzione ChooseFont per inizializzare la finestra di dialogo Tipo di carattere . Dopo che l'utente chiude la finestra di dialogo, il sistema restituisce informazioni sulla selezione dell'utente in questa struttura. |
| DEVNAMES | Contiene stringhe che identificano i nomi dei driver, del dispositivo e delle porte di output per una stampante. Le funzioni PrintDlgEx e PrintDlg utilizzano queste stringhe per inizializzare la finestra di dialogo stampa o stampa definita dal sistema. Quando l'utente chiude la finestra di dialogo o la finestra di dialogo delle proprietà, le informazioni sulla stampante selezionata vengono restituite in questa struttura. |
| FINDREPLACE | Contiene informazioni utilizzate 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 di proprietario di una finestra di dialogo Trova o Sostituisci . |
| OFNOTIFY | C contiene informazioni su un messaggio di WM_NOTIFY inviato a una routine hook OFNHookProc per una finestra di dialogo Apri o Salva con nome. Il parametro lParam del messaggio WM_NOTIFY è un puntatore a una struttura OFNOTIFY . |
| OFNOTIFYEX | Contiene informazioni su un messaggio di notifica CDN_INCLUDEITEM . |
| OPENFILENAME | Contiene informazioni utilizzate dalle funzioni GetOpenFileName e GetSaveFileName per inizializzare una finestra di dialogo Apri o Salva con nome. Dopo che l'utente chiude 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 utilizzate dalla funzione PageSetupDlg per inizializzare la finestra di dialogo Imposta pagina. Dopo che l'utente chiude la finestra di dialogo, il sistema restituisce informazioni sui parametri di pagina definiti dall'utente in questa struttura. |
| PRINTDLG | Contiene informazioni utilizzate dalla funzione PrintDlg per inizializzare la finestra di dialogo stampa. Dopo che l'utente chiude la finestra di dialogo, il sistema usa questa struttura per restituire informazioni sulle selezioni dell'utente. |
| PRINTDLGEX | Contiene informazioni utilizzate dalla funzione PrintDlgEx per inizializzare la finestra delle proprietà Print. Dopo che l'utente chiude la finestra 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. |