TN062: reflection di messaggio per i controlli Windows
[!NOTA]
La seguente nota tecnica non è stata aggiornata dalla prima volta che viene inclusa nella documentazione online.Di conseguenza, alcune procedure e argomenti potrebbero non essere aggiornati o errati.Per le informazioni più recenti, è consigliabile cercare l'argomento di interesseindice 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 un controllo Windows.
Qual è la reflection di messaggio?
I controlli Windows per l'invio dei 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 in MFC precedenti alla versione 4,0, la finestra padre, spesso una finestra di dialogo, è responsabile della gestione dei messaggi.Ciò significa che il codice per la gestione che il messaggio sia la classe della finestra padre e che deve essere duplicato in ogni classe che deve gestire il messaggio.Nel caso precedente, ogni finestra di dialogo che i controlli desiderati con gli 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 può gestire i messaggi di notifica.Inoltre, tuttavia, MFC 4,0 semplifica il riutilizzo fornendo una funzionalità denominata “reflection di messaggio„ che consente questi messaggi di notifica da gestire nella finestra di controllo figlio o nella finestra padre, o in entrambi.Nell'esempio del colore di sfondo del controllo, è ora possibile scrivere una classe del controllo che imposta il relativo colore di sfondo gestisce il messaggio riprodotto di WM_CTLCOLOR — tutto senza basarsi sull'oggetto padre.Si noti 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 precedenti di MFC hanno eseguito un'operazione simile alla reflection di messaggio fornendo alle 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 è compatibile 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, ignorerà ha riprodotto 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 eseguirà l'override di tutti i 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 dei messaggi, il gestore di messaggi può consentire della finestra padre gestisce il messaggio.Se il gestore restituisce FALSE, il messaggio verrà gestito dal padre anche, mentre una chiamata che restituisce TRUE non permette al padre dall'.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 possibilità di gestire e il controllo riceve il messaggio riprodotto.A tale scopo, dovrà disporre di una funzione di gestione e di una voce appropriata nella mappa messaggi della 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 nel controllo padre, utilizzare macro ON_NOTIFY della mappa messaggi del 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 possibile aggiungere voci della mappa messaggi per l'utente e fornire le 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 i prototipi di funzione elencata nella tabella riportata di seguito.
ClassWizard in genere possibile aggiungere queste voci della mappa messaggi per l'utente e fornire le implementazioni di base di funzione.Vedere Definizione del gestore messaggi per un messaggio riprodotto per informazioni su come definire i gestori per i messaggi riprodotti.
Per convertire il nome del messaggio al 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, eseguire la conversione opposta sulle macro di 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 del gestore.In altri casi, è necessario utilizzare il nome standard per la funzione di gestione.
I significati di parametri e i valori restituiti delle funzioni sono documentati in o del nome della funzione o il nome di funzione con Attivato è anteposto.Ad esempio, CtlColor è documentato in OnCtlColor.Diversi gestori di messaggi riprodotti sono necessarie meno parametri che i gestori simili in una finestra padre.Corrispondere ai nomi nella tabella riportata di seguito 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 ) |
risultato);diafx_msg void memberFxn ( NMHDR * pNotifyStruct, LRESULT* |
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ù di un oggetto (come il controllo e il relativo padre) per gestire un messaggio specificato.
Voce di mapping |
Prototipo di funzione |
|---|---|
ON_NOTIFY_REFLECT_EX( wNotifyCode, memberFxn ) |
risultato);diafx_msg BOOL memberFxn ( NMHDR * pNotifyStruct, LRESULT* |
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 esattamente come controllo di modifica normale salvo che visualizza il testo nero su uno sfondo giallo.Risulta facile aggiungere funzioni membro che avrebbe consentito il controllo di CYellowEdit ai colori diversi della visualizzazione.
Per eseguire 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 della finestra di dialogo .
È necessario disporre di 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 utilizzerà 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 del 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 bkgndPer creare un controllo di modifica nella finestra di dialogo, quindi connetterlo 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 di aggiunta, completare il nome della variabile e scegliere il “controllo„ per categoria, quindi “CYellowEdit„ per il tipo di variabile.Non dimenticare 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.