TN062: reflection messaggi per controlli Windows
Nota
La seguente nota tecnica non è stata aggiornata da quando è stata inclusa per la prima volta nella documentazione online.Di conseguenza, alcune procedure e argomenti potrebbero essere non aggiornati o errati.Per le informazioni più recenti, è consigliabile cercare l'argomento di interesse nell'indice della documentazione online.
Questa nota tecnica viene descritta la reflection di messaggio, una nuova funzionalità di MFC 4,0. Contiene inoltre fornite indicazioni per creare un controllo riutilizzabile semplice che utilizza la reflection di messaggio.
Questa nota tecnica non viene descritta la reflection di messaggio mentre si applica ai controlli ActiveX (precedentemente denominati controlli OLE). Vedere l'articolo Controlli ActiveX: Creazione di una sottoclasse di un controllo Windows.
Qual è la reflection di messaggio?
I controlli Windows inviano spesso i messaggi di notifica alle finestre padre. Ad esempio, molti controlli inviare un messaggio di notifica colore del controllo (WM_CTLCOLOR o una delle varianti) al relativo padre per consentire al padre fornisca un pennello per il disegno dello sfondo del controllo.
In windows e a MFC precedenti alla versione 4,0, la finestra padre, spesso una finestra di dialogo, è responsabile della gestione dei messaggi. Ciò significa che il codice di gestione che il messaggio deve trovarsi nella classe della finestra padre e che deve essere duplicato in ogni classe che deve gestire il messaggio. Nel caso precedente, tutte le finestre di dialogo che i controlli desiderati con sfondi personalizzati devono gestire il messaggio di notifica colore del controllo. Sarebbe molto più facile riutilizzare il codice se una classe del controllo potrebbe essere scritta che gestirebbe il relativo colore di sfondo.
In MFC 4,0, il meccanismo funziona obsoleti nuovamente alle finestre padre possono gestire i messaggi di notifica. Inoltre, tuttavia, MFC 4,0 semplifica il riutilizzo fornendo una funzionalità denominata "reflection di messaggio" che consente i messaggi di notifica da gestire nella finestra di controllo figlio o nella finestra padre, o in entrambi. Nell'esempio di colore di sfondo del controllo, è possibile scrivere una classe di controllo che imposta il relativo colore di sfondo del messaggio riprodotto di WM_CTLCOLOR - tutto senza utilizzare il padre. Notare che poiché la reflection di messaggio viene implementata da MFC, non da windows, la classe della finestra padre deve essere derivata da CWnd per la reflection di messaggio funzioni).
Le versioni di MFC precedenti a un'operazione simile alla reflection di messaggio svolgendo le funzioni virtuali per alcuni messaggi, ad esempio i messaggi per le caselle di riepilogo create dal proprietario (WM_DRAWITEM, e così via). Il nuovo meccanismo di reflection di messaggio è generalizzato e coerente.
La reflection di messaggio sono compatibili con codice scritto per le versioni di MFC precedenti a 4,0.
Se è stato fornito un gestore per un messaggio specifico, o per un intervallo dei messaggi, nella classe della finestra padre, di override presenta riflesso i gestori di messaggi per lo stesso messaggio viene fornito non chiama la funzione di gestione della classe base nel proprio gestore. Ad esempio, se si gestiscono WM_CTLCOLOR nella classe della finestra di dialogo, la gestione eseguire l'override di eventuali gestori di messaggi riprodotti.
Se, nella classe della finestra padre, fornire un gestore per un messaggio specifico di WM_NOTIFY o un intervallo dei messaggi di WM_NOTIFY, il gestore viene chiamato solo se il controllo figlio che invia i messaggi non dispone di un gestore messaggi riprodotto con ON_NOTIFY_REFLECT(). Se si utilizza ON_NOTIFY_REFLECT_EX() nella mappa messaggi, il gestore di messaggi può consentire la finestra padre gestire il messaggio. Se il gestore restituisce FALSE, il messaggio verrà gestito dal padre anche, mentre una chiamata che restituisce TRUE non permette al padre di gestione. Si noti che il messaggio riprodotto viene gestito prima del messaggio di notifica.
Quando un messaggio di WM_NOTIFY viene inviato, il controllo viene offerto la prima probabilità gestirla. Se qualsiasi altro messaggio riprodotto viene inviato, la finestra padre è la prima probabilità di gestirlo e il controllo riceve il messaggio riprodotto. A tale scopo, sarà necessario disporre di una funzione di gestione e di una voce appropriata nella mappa messaggi la classe del controllo.
La macro della mappa messaggi per i messaggi riprodotti è leggermente diversa rispetto alle notifiche normali: è _REFLECT aggiunto al nome comune. Ad esempio, per gestire un messaggio di WM_NOTIFY pannello padre, utilizzare macro ON_NOTIFY della mappa messaggi padre. Per gestire il messaggio riprodotto nel controllo figlio, utilizzare la macro di ON_NOTIFY_REFLECT della mappa messaggi del controllo figlio. In alcuni casi, i parametri sono diversi, anche. Si noti che ClassWizard in genere aggiungere voci della mappa messaggi per l'utente e fornire implementazioni di base di funzione con parametri corretti.
Vedere TN061: Messaggi di WM_NOTIFY e di ON_NOTIFY per informazioni sul nuovo messaggio di WM_NOTIFY.
Le voci della mappa messaggi e prototipi di funzione di gestione per i messaggi riprodotti
Per gestire un messaggio riprodotto di notifica di controllo, utilizzare le macro della mappa messaggi e prototipi di funzione elencati nella tabella riportata di seguito.
ClassWizard in genere aggiungere queste voci della mappa messaggi per l'utente e fornire implementazioni di base di funzione. Vedere Definizione di un gestore messaggi per un messaggio riprodotto per informazioni su come definire i gestori per i messaggi riprodotti.
Per convertire il nome del messaggio in nome della macro riflesso, anteporre ON_ e aggiungere _REFLECT. Ad esempio, WM_CTLCOLOR diventa ON_WM_CTLCOLOR_REFLECT. (Per visualizzare i messaggi possono essere riprodotti, effettuare la conversione opposta sulle macro voci nella tabella riportata di seguito.)
Le tre eccezioni alla regola precedente sono le seguenti:
La macro per le notifiche di WM_COMMAND è ON_CONTROL_REFLECT.
La macro per reflection di WM_NOTIFY è ON_NOTIFY_REFLECT.
La macro per reflection di ON_UPDATE_COMMAND_UI è ON_UPDATE_COMMAND_UI_REFLECT.
In ognuno dei casi speciali in precedenza, è necessario specificare il nome della funzione membro gestore. In altri casi, è necessario utilizzare il nome standard per la funzione di gestione.
I significati di parametri e i valori restituiti da funzioni sono documentati in o il nome della funzione o il nome di funzione con In è anteposto. Ad esempio, CtlColor è documentato in OnCtlColor. Diversi gestori di messaggi riprodotti sono necessarie meno parametri simili che i gestori in una finestra padre. Corrispondenza dei nomi indicati nella tabella seguente con i nomi dei parametri formali nella documentazione.
Voce di mapping |
Prototipo di funzione |
|---|---|
ON_CONTROL_REFLECT( wNotifyCode, memberFxn ) |
afx_msg void memberFxn ( ); |
ON_NOTIFY_REFLECT( wNotifyCode, memberFxn ) |
afx_msg void memberFxn ( NMHDR * pNotifyStruct, LRESULT* risultato ); |
ON_UPDATE_COMMAND_UI_REFLECT( memberFxn ) |
afx_msg void memberFxn ( CCmdUI* pCmdUI); |
ON_WM_CTLCOLOR_REFLECT( ) |
afx_msg HBRUSH CtlColor ( CDC* pDC, UINT nCtlColor ); |
ON_WM_DRAWITEM_REFLECT( ) |
afx_msg void DrawItem ( LPDRAWITEMSTRUCT lpDrawItemStruct ); |
ON_WM_MEASUREITEM_REFLECT( ) |
afx_msg void MeasureItem ( LPMEASUREITEMSTRUCT lpMeasureItemStruct ); |
ON_WM_DELETEITEM_REFLECT( ) |
afx_msg void DeleteItem ( LPDELETEITEMSTRUCT lpDeleteItemStruct ); |
ON_WM_COMPAREITEM_REFLECT( ) |
afx_msg int CompareItem ( LPCOMPAREITEMSTRUCT lpCompareItemStruct ); |
ON_WM_CHARTOITEM_REFLECT( ) |
afx_msg int CharToItem ( UINT nKey, UINT nIndex ); |
ON_WM_VKEYTOITEM_REFLECT( ) |
afx_msg int VKeyToItem ( UINT nKey, UINT nIndex ); |
ON_WM_HSCROLL_REFLECT( ) |
afx_msg void HScroll ( UINT nSBCode, UINT nPos ); |
ON_WM_VSCROLL_REFLECT( ) |
afx_msg void VScroll ( UINT nSBCode, UINT nPos ); |
ON_WM_PARENTNOTIFY_REFLECT( ) |
afx_msg void ParentNotify ( UINT message, LPARAM lParam ); |
Le macro di ON_CONTROL_REFLECT e di ON_NOTIFY_REFLECT sono variazioni che consentono a più oggetti (come il controllo e il relativo padre) gestire un messaggio specificato.
Voce di mapping |
Prototipo di funzione |
|---|---|
ON_NOTIFY_REFLECT_EX( wNotifyCode, memberFxn ) |
afx_msg BOOL memberFxn ( NMHDR * pNotifyStruct, LRESULT* risultato ); |
ON_CONTROL_REFLECT_EX( wNotifyCode, memberFxn ) |
afx_msg BOOL memberFxn ( ); |
Gestire i messaggi riprodotti: Un esempio di un controllo riutilizzabile
In questo semplice esempio viene creato un controllo riutilizzabile chiamato CYellowEdit. Il controllo funziona come se fosse controllo di modifica normale salvo che visualizzano testo nero su uno sfondo giallo. Risulta facile aggiungere funzioni membro che avrebbe consentito il controllo di CYellowEdit in colori diversi di visualizzazione.
Per provare l'esempio che crea un controllo riutilizzabile
Creare una nuova finestra di dialogo in un'applicazione esistente. Per ulteriori informazioni, vedere l'argomento di editor finestre.
È necessario che un'applicazione in cui compilare il controllo riutilizzabile. Se non si dispone di un'applicazione esistente da utilizzare, creare un'applicazione a finestre mediante AppWizard.
Con il progetto caricato in Visual C++, utilizzare ClassWizard per creare una nuova classe denominata CYellowEdit basato su CEdit.
Aggiungere le variabili di tre membri alla classe di CYellowEdit. I primi due verranno variabili di COLORREF per utilizzare il colore del testo e il colore di sfondo. Il terzo sarà un oggetto di CBrush che conterrà il pennello per il disegno dello sfondo. L'oggetto di CBrush consente di creare una volta il pennello, solo facendo riferimento successivamente e distruggiate il pennello automaticamente quando il controllo di CYellowEdit viene eliminato.
Inizializzare le variabili membro scrivendo il costruttore come segue:
CYellowEdit::CYellowEdit() { m_clrText = RGB( 0, 0, 0 ); m_clrBkgnd = RGB( 255, 255, 0 ); m_brBkgnd.CreateSolidBrush( m_clrBkgnd ); }Utilizzo di ClassWizard, aggiungere un gestore per il messaggio riprodotto di WM_CTLCOLOR alla classe di CYellowEdit. Si noti che il segno di uguale davanti al nome del messaggio nell'elenco dei messaggi che è possibile gestire indica che il messaggio viene applicato. Ciò viene descritto in Definizione di un gestore messaggi per un messaggio riprodotto.
ClassWizard aggiunge la macro riportata della mappa messaggi e la funzione di base automaticamente:
ON_WM_CTLCOLOR_REFLECT() // Note: other code will be in between.... HBRUSH CYellowEdit::CtlColor(CDC* pDC, UINT nCtlColor) { // TODO: Change any attributes of the DC here // TODO: Return a non-NULL brush if the // parent's handler should not be called return NULL; }Sostituire il corpo della funzione con il codice seguente. Il codice consente di specificare il colore del testo, il colore di sfondo del testo e il colore di sfondo per resto del controllo.
pDC->SetTextColor( m_clrText ); // text pDC->SetBkColor( m_clrBkgnd ); // text bkgnd return m_brBkgnd; // ctl bkgndCreare un controllo di modifica nella finestra di dialogo, quindi alleghilo a una variabile membro facendo doppio clic sul controllo di modifica tenendo premuto un tasto di un controllo verso il basso. Nella finestra di dialogo variabile membro aggiungi, completare il nome della variabile e scegliere il "controllo" per categoria, pertanto "CYellowEdit" per il tipo di variabile. Non dimentichi di impostare l'ordine di tabulazione nella finestra di dialogo. Inoltre, assicurarsi di includere il file di intestazione per il controllo di CYellowEdit in file di intestazione della finestra di dialogo.
Compilare ed eseguire l'applicazione. Il controllo di modifica avrà uno sfondo giallo.