テクニカルノート 62: Windows コントロールへのメッセージリフレクション (メッセージ返送)

[アーティクル]
08/09/2011

注意

次のテクニカルノートは、最初にオンラインドキュメントの一部とされてから更新されていません。結果として、一部のプロシージャおよびトピックが最新でないか、不正になります。最新の情報について、オンラインドキュメントのキーワードで関係のあるトピックを検索することをお勧めします。

このテクニカルノートでは、MFC 4.0 の新機能であるメッセージリフレクション (メッセージ返送) について説明します。メッセージリフレクションを使用する単純で再利用可能なコントロールの作成手順も説明します。

このテクニカルノートでは、ActiveX コントロールに当てはまるようなメッセージリフレクションについては触れていません。記事を参照してくださいActiveX コントロール:Windows コントロールをサブクラス化。

メッセージリフレクション (メッセージ返送) とは

Windows コントロールは、頻繁に親ウィンドウに通知メッセージを送ります。たとえば、多くのコントロールは、コントロールの背景を描画するブラシを親ウィンドウが用意できるようにするため、親ウィンドウにコントロールカラー通知メッセージ (WM_CTLCOLOR またはそのバリエーションの 1 つ) を送ります。

Windows および MFC 4.0 以前のバージョンでは、このようなメッセージの処理は親ウィンドウ (多くの場合はダイアログボックス) が受け持っています。このため、メッセージの処理コードを親ウィンドウのクラスに置き、そのメッセージの処理が必要なすべてのクラスにおいて複製することが必要です。この場合、独自の背景を持つコントロールを使用するすべてのダイアログボックスでは、コントロールカラー通知メッセージを処理する必要があります。独自の背景色を処理するコントロールクラスを作成しておくと、コードの再利用ははるかに簡単になります。

MFC 4.0 では、従来の機構も引き続き動作します。親ウィンドウで通知メッセージを処理できます。ただし、それに加えて、MFC 4.0 では "メッセージリフレクション" と呼ばれる機能が用意されており、再利用が簡単になっています。この機能によって、通知メッセージを子コントロールウィンドウ、親ウィンドウ、またはその両方で処理できます。コントロールの背景色の例では、リフレクションされた WM_CTLCOLOR メッセージを処理することで、親ウィンドウにまったく依存せずに、独自の背景色を設定するコントロールクラスを作成できるようになりました。メッセージリフレクションは Windows ではなく MFC によって実装されるため、メッセージリフレクションを動作させるには、CWnd から親ウィンドウクラスを派生させる必要があります。

以前のバージョンの MFC では、オーナーが描画したリストボックスに関するメッセージ (WM_DRAWITEM など) のようないくつかのメッセージについて仮想関数を用意することで、メッセージリフレクションに似た機能がありました。新しいメッセージリフレクション機構は汎用化されており、一貫性を持っています。

メッセージリフレクションには、MFC 4.0 より前のバージョン向けに作成されたコードとの下位互換性があります。

特定のメッセージまたはメッセージの範囲について、親ウィンドウのクラスでハンドラーを指定した場合は、作成したハンドラー内で基本クラスのハンドラー関数を呼び出さない限り、同じメッセージについてリフレクションメッセージハンドラーがオーバーライドされます。たとえば、作成したダイアログボックスクラスで WM_CTLCOLOR を処理する場合は、リフレクションメッセージハンドラーがオーバーライドされます。

親ウィンドウクラスで特定の WM_NOTIFY メッセージまたは WM_NOTIFY メッセージの範囲に関するハンドラーを作成した場合は、該当するメッセージを送信する子コントロールが ON_NOTIFY_REFLECT() を通じてリフレクションメッセージハンドラーを持たない場合に限り、作成したハンドラーが呼び出されます。メッセージマップに ON_NOTIFY_REFLECT_EX() を使用する場合、メッセージハンドラーは親ウィンドウでメッセージを処理できるようにするものであってもなくてもかまいません。ハンドラーが FALSE を返すと、メッセージは親ウィンドウによって処理されますが、呼び出しで TRUE が返されると親ウィンドウではメッセージを処理できません。リフレクションメッセージは、通知メッセージの前に処理されます。

WM_NOTIFY メッセージが送信されると、コントロールはそのメッセージを最初に処理するように求められます。他にもリフレクションメッセージが送信されると、親ウィンドウが最初に処理を行い、コントロールはリフレクションメッセージを受け取ります。リフレクションメッセージを受け取るには、コントロールのクラスメッセージマップにハンドラー関数と適切なエントリが必要です。

リフレクションメッセージのメッセージマップマクロは、通常の通知のよりもわずかに異なるです。それが**_REFLECT**、通常の名前に追加されます。たとえば、親ウィンドウで WM_NOTIFY メッセージを処理するには、親ウィンドウのメッセージマップ内でマクロ ON_NOTIFY を使用します。リフレクションメッセージを子コントロールで処理するには、子コントロールのメッセージマップ内で ON_NOTIFY_REFLECT マクロを使用します。パラメーターが異なる場合もあります。通常、ClassWizard ではメッセージマップエントリを追加でき、適切なパラメーターを伴うスケルトン関数の実装が用意されています。

参照してくださいTN061:ON_NOTIFY WM_NOTIFY メッセージについては、新しい WM_NOTIFYメッセージ。

リフレクションメッセージ用のメッセージマップエントリとハンドラー関数プロトタイプ

リフレクションされたコントロール通知メッセージを処理するには、次の表に示すメッセージマップマクロと関数プロトタイプを使用します。

通常、ClassWizard ではこれらのメッセージマップエントリを追加でき、スケルトン関数の実装が用意されています。リフレクションされたメッセージ用のハンドラーを定義する方法については、「リフレクションメッセージ用のメッセージハンドラーの定義」を参照してください。

メッセージ名をリフレクションされたマクロ名に変換するには、前に ON_、後に _REFLECT を付けます。たとえば、WM_CTLCOLOR は ON_WM_CTLCOLOR_REFLECT となります。どのメッセージをリフレクションできるかを確認するには、次の表のマクロエントリを逆変換します。

ただし、上の規則には次の 3 つの例外があります。

WM_COMMAND 通知用のマクロは ON_CONTROL_REFLECT です。
WM_NOTIFY リフレクション用のマクロは ON_NOTIFY_REFLECT です。
ON_UPDATE_COMMAND_UI リフレクション用のマクロは ON_UPDATE_COMMAND_UI_REFLECT です。

これらの特殊ケースの場合は、それぞれハンドラーメンバー関数の名前を指定する必要があります。それ以外の場合は、ハンドラー関数の標準名を使用します。

関数のパラメーターと戻り値の意味については、関数名または On で始まる関数名を参照してください。たとえば、CtlColor については OnCtlColor を参照してください。リフレクションメッセージハンドラーの中には、親ウィンドウ内の同様のハンドラーよりも必須となるパラメーターの数が少ないものがあります。ドキュメントにある正式なパラメーター名と、次の表にあるパラメーター名を突き合わせてください。

マップエントリ	関数プロトタイプ
ON_CONTROL_REFLECT( wNotifyCode, memberFxn )	afx_msg void memberFxn ( );
ON_NOTIFY_REFLECT( wNotifyCode, memberFxn )	afx_msg void memberFxn ( NMHDR * pNotifyStruct, LRESULT* result );
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 );

ON_NOTIFY_REFLECT マクロと ON_CONTROL_REFLECT マクロには、特定のメッセージを複数のオブジェクト (コントロールとその親など) が処理できるようにバリエーションが用意されています。

マップエントリ	関数プロトタイプ
ON_NOTIFY_REFLECT_EX( wNotifyCode, memberFxn )	afx_msg BOOL memberFxn ( NMHDR * pNotifyStruct, LRESULT* result );
ON_CONTROL_REFLECT_EX( wNotifyCode, memberFxn )	afx_msg BOOL memberFxn ( );

処理のメッセージを反映しました。再利用可能なコントロールの例

この単純な例では、再利用可能なコントロール CYellowEdit を作成します。コントロールは通常のエディットコントロールと同様に動作しますが、黄色の背景に黒い文字を表示します。 CYellowEdit コントロールでは、別の色を表示できるようにするためのメンバー関数を簡単に追加できます。

再利用可能なコントロールの作成例を試すには

既存のアプリケーション内で新規のダイアログボックスを作成します。詳細については、「ダイアログエディター」を参照してください。

再利用可能なコントロールの開発に使用するアプリケーションを用意する必要があります。既存アプリケーションを使用しない場合は、AppWizard を使用してダイアログベースのアプリケーションを作成します。
プロジェクトを Visual C++ に読み込み、ClassWizard を使用して、CEdit に基づいて CYellowEdit という新規のクラスを作成します。
CYellowEdit クラスに 3 つのメンバー変数を追加します。最初の 2 つは、文字の色と背景色を保持する COLORREF 変数です。 3 番目は、背景を描画するブラシを保持する CBrush オブジェクトです。 CBrush オブジェクトを使用すると、ブラシをいったん作成し、その後は参照するだけで、CYellowEdit コントロールが破棄されるときにブラシを自動的に破棄できます。

次のようなコンストラクターを記述し、メンバー変数を初期化します。

CYellowEdit::CYellowEdit()
{
   m_clrText = RGB( 0, 0, 0 );
   m_clrBkgnd = RGB( 255, 255, 0 );
   m_brBkgnd.CreateSolidBrush( m_clrBkgnd );
}

ClassWizard を使用して、リフレクションされる WM_CTLCOLOR メッセージ用のハンドラーを CYellowEdit クラスに追加します。処理できるメッセージの一覧内で、メッセージ名の前にある等号は、そのメッセージがリフレクションされることを示します。詳細については、「リフレクションメッセージ用のメッセージハンドラーの定義」を参照してください。

ClassWizard によって、次のメッセージマップマクロとスケルトン関数が追加されます。
```
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;
}
```
関数本体を次のコードに置き換えます。このコードでは文字の色、文字の背景色、およびコントロールの残りの部分の背景色を指定しています。
```
   pDC->SetTextColor( m_clrText );   // text
   pDC->SetBkColor( m_clrBkgnd );   // text bkgnd
   return m_brBkgnd;            // ctl bkgnd
```
ダイアログボックスのエディットコントロールを作成し、Ctrl キーを押しながらエディットコントロールをダブルクリックし、メンバー変数にアタッチします。 [メンバー変数の追加] ダイアログボックスで、変数名を入力し、カテゴリに "コントロール"を選択し、変数の種類に "CYellowEdit"を選択します。このダイアログボックスでは、タブオーダーを必ず設定するようにしてください。また、ダイアログボックスのヘッダーファイルに CYellowEdit コントロールのヘッダーファイルを含める必要があります。
アプリケーションをビルドして実行します。エディットコントロールが黄色の背景になります。

参照

その他の技術情報

番号順テクニカルノート

カテゴリ別テクニカルノート

次の方法で共有

テクニカルノート 62: Windows コントロールへのメッセージリフレクション (メッセージ返送)

処理のメッセージを反映しました。再利用可能なコントロールの例

再利用可能なコントロールの作成例を試すには

参照

その他の技術情報

その他のリソース

次の方法で共有

テクニカル ノート 62: Windows コントロールへのメッセージ リフレクション (メッセージ返送)

処理のメッセージを反映しました。再利用可能なコントロールの例

再利用可能なコントロールの作成例を試すには

参照

その他の技術情報

その他のリソース

テクニカルノート 62: Windows コントロールへのメッセージリフレクション (メッセージ返送)