通常、コントロールはWM_COMMANDメッセージ
（コモンコントロールの場合はWM_NOTIFYメッセージ）を親ウィンドウに送信し、
親ウィンドウはそれらのメッセージに応答して処理を実行します。
しかし、コントロールが送るそのようなメッセージを、
親ウィンドウではなくそのコントロール自身に応答させたい場合があります。
メッセージリフレクションは、それを実現する仕組みです。
メッセージリフレクションを使うと、コントロールが親ウィンドウに送ったメッセージは
親ウィンドウからコントロールに返送され、コントロールが応答することができます。
次に示すのは、メッセージリフレクションに対応した親ウィンドウクラスのメッセージマップです。
// 親ウィンドウ
class CSampleProjectDialog : public ...
{
...
...
// メッセージマップ
BEGIN_MSG_MAP(CSampleProjectDialog)
MSG_WM_INITDIALOG(OnInitDialog)
...
...
REFLECT_NOTIFICATIONS() // 処理されなかったメッセージを返送
END_MSG_MAP()
...
...
|
親ウィンドウクラス（今回の例ではCSampleProjectDialog）はコントロールからのメッセージを受け取ると、
メッセージマップにそのメッセージ用のメッセージマップエントリがあるかどうか調べます。
該当するメッセージマップエントリがなければ、
REFLECT_NOTIFICATIONSマクロによってメッセージを送ってきたコントロールに返送します。
次に、返送されたメッセージに応答するコントロールクラスを定義します。
以下に示すのは、ボタンのキャプション文字列をURLと仮定し、
ボタンを押すとそのURLをWebブラウザで開くボタン（URLボタン）を定義する例です。
プロジェクトにUrlButton.hというヘッダを追加し、
そこにCUrlButtonというクラスを定義します。
// UrlButton.h
#pragma once
class CUrlButton : public CWindowImpl<CUrlButton>
{
public:
DECLARE_WND_SUPERCLASS(_T("UrlButton"), _T("BUTTON"))
BEGIN_MSG_MAP(CUrlButton)
MSG_OCM_COMMAND(OnCommand)
DEFAULT_REFLECTION_HANDLER()
END_MSG_MAP()
void OnCommand(UINT uNotifyCode, int nID, CWindow wndCtl){
TCHAR szURL[256];
GetWindowText(szURL, sizeof(szURL)/sizeof(TCHAR));
SHELLEXECUTEINFO si = { sizeof(SHELLEXECUTEINFO) };
si.hwnd = m_hWnd;
si.lpVerb = _T("Open");
si.lpFile = szURL;
si.nShow = SW_SHOWNORMAL;
ShellExecuteEx(&si);
}
};
|
CUrlButtonでは、親ウィンドウから返送されたWM_COMMANDメッセージを処理します。
WTLは、返送されたメッセージをOCM_で始まるメッセージ
（OCM_COMMANDやOCM_NOTIFYやOCM_CTLCOLORBTNなど）
に置き換えます。
また、返送されたメッセージのためのメッセージマクロを用意しています。
今回の例では、OCM_COMMANDメッセージをMSG_OCM_COMMANDメッセージマクロによって、
OnCommand()にマッピングしています。
OnCommand()では、ボタンのキャプションであるURL文字列を取得し、Webブラウザで開きます。
なお、処理されなかったメッセージはDEFAULT_REFLECTION_HANDLERマクロによって処理されます。
最後に、コントロールを作成する必要があります。
コントロールを作成するためにはCreate()を呼び出しますが、
SubclassWindow()を呼び出して既存のコントロールをサブクラス化することもできます。
class CSampleProjectDialog : public ...
{
...
...
enum { IDC_BUTTON_URL = 1200 };
CUrlButton m_button_url;
BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){
// コントロール作成
m_button_url.Create(m_hWnd, CRect(10, 10, 200, 35),
_T("http://wtl.sourceforge.net/"),
WS_CHILD | WS_VISIBLE, 0, IDC_BUTTON_URL);
// または既存のコントロールをサブクラス化
// m_button_url.SubclassWindow(GetDlgItem(IDC_BUTTON_URL));
return TRUE;
}
...
...
|
このように、メッセージリフレクションを使用すると、
コントロールが親ウィンドウに送ったメッセージに対する動作を、コントロール自身で実装できるため、
コントロールの独立性を高めることができます。
次に示すのは、CUrlButtonクラスを使用する例です。
// stdafx.h
#pragma once
#define WINVER 0x0420
#include <atlbase.h>
#if _ATL_VER == 0x900
#define _SECURE_ATL 1
#endif
#define _WTL_USE_CSTRING
#include <atlapp.h>
extern CAppModule _Module;
#include <atlwin.h>
#include <tpcshell.h>
#include <aygshell.h>
#pragma comment(lib, "aygshell.lib")
#include <atlcrack.h>
#include <atlmisc.h>
#include <atlframe.h>
#include <atlctrls.h>
#define _WTL_CE_NO_ZOOMSCROLL
#define _WTL_CE_NO_FULLSCREEN
#include <atlwince.h>
|
// SampleProjectDialog.h
#pragma once
class CSampleProjectDialog :
public CAppStdDialogImpl<CSampleProjectDialog>,
public CUpdateUI<CSampleProjectDialog>,
public CMessageFilter, public CIdleHandler
{
public:
DECLARE_APP_DLG_CLASS(NULL, IDR_MAINFRAME, L"Software\\WTL")
enum { IDD = IDD_MAINDLG };
CUrlButton m_button_url;
virtual BOOL PreTranslateMessage(MSG* pMsg){
return CWindow::IsDialogMessage(pMsg);
}
virtual BOOL OnIdle(){
return FALSE;
}
BEGIN_UPDATE_UI_MAP(CSampleProjectDialog)
END_UPDATE_UI_MAP()
BEGIN_MSG_MAP(CSampleProjectDialog)
MSG_WM_INITDIALOG(OnInitDialog)
MSG_WM_DESTROY(OnDestroy)
CHAIN_MSG_MAP(CUpdateUI<CSampleProjectDialog>)
CHAIN_MSG_MAP(CAppStdDialogImpl<CSampleProjectDialog>)
REFLECT_NOTIFICATIONS() // メッセージを返送
END_MSG_MAP()
BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){
AtlCreateEmptyMenuBar(m_hWnd);
// コントロールサブクラス化
m_button_url.SubclassWindow(GetDlgItem(IDC_BUTTON_URL));
// メッセージループにメッセージフィルタとアイドルハンドラを追加
CMessageLoop* pLoop = _Module.GetMessageLoop();
pLoop->AddMessageFilter(this);
pLoop->AddIdleHandler(this);
SetMsgHandled(false);
return TRUE;
}
void OnDestroy(){
// メッセージループからメッセージフィルタとアイドルハンドラを削除
CMessageLoop* pLoop = _Module.GetMessageLoop();
pLoop->RemoveMessageFilter(this);
pLoop->RemoveIdleHandler(this);
}
};
|
// SampleProject.cpp
#include "stdafx.h"
#include "resourceppc.h"
#include "UrlButton.h"
#include "SampleProjectDialog.h"
CAppModule _Module;
int WINAPI _tWinMain(HINSTANCE hInstance,
HINSTANCE /*hPrevInstance*/, LPTSTR lpstrCmdLine, int nCmdShow)
{
HRESULT hRes =
CSampleProjectDialog::ActivatePreviousInstance(hInstance, lpstrCmdLine);
if(FAILED(hRes) || S_FALSE == hRes){
return hRes;
}
hRes = ::CoInitializeEx(NULL, COINIT_MULTITHREADED);
ATLASSERT(SUCCEEDED(hRes));
AtlInitCommonControls(ICC_DATE_CLASSES);
SHInitExtraControls();
hRes = _Module.Init(NULL, hInstance);
ATLASSERT(SUCCEEDED(hRes));
int nRet = CSampleProjectDialog::AppRun(lpstrCmdLine, nCmdShow);
_Module.Term();
::CoUninitialize();
return nRet;
}
|
まず、リソースを作成します。ダイアログにボタンコントロールを配置し、
［ID］と［Caption］を次のように指定します。
なお、ボタンのキャプションには有効なURL文字列を設定します。
| コントロール名 |
ID |
Caption |
| ボタン |
IDC_BUTTON_URL |
http://wtl.sourceforge.net/ |
次に、CSampleProjectDialogクラスでURLボタン用に
CUrlButtonクラスのインスタンスをメンバ変数として宣言します。
これを使うためには、WM_INITDIALOGメッセージハンドラでSubclassWindow()を呼び出します。
最後に、SampleProject.cppファイルでSampleProjectDialog.hヘッダの前にUrlButton.hヘッダをインクルードします。
ところで、今回は返送されたメッセージのマッピングにMSG_OCM_COMMANDメッセージマクロを使用しましたが、
WTLは返送されたメッセージ用に次のような種類のメッセージマクロを用意しています。
|
