サブクラス化すると、既存のウィンドウ（例えばダイアログ上のコントロール）の動作を拡張することができます。
以下に示すのは、ダイアログ上のボタンコントロールをサブクラス化して、
タップするとビープ音が鳴るボタン（ビープボタン）を定義する例です。
プロジェクトにBeepButton.hというヘッダファイルを追加し、
そこにCBeepButtonというクラスを定義します。
// BeepButton.h
#pragma once
class CBeepButton : public CWindowImpl<CBeepButton>
{
public:
BEGIN_MSG_MAP(CBeepButton)
MSG_WM_LBUTTONDOWN(OnLButtonDown)
END_MSG_MAP()
void OnLButtonDown(UINT nFlags, CPoint point){
MessageBeep(MB_ICONASTERISK);
SetMsgHandled(false);
}
};
|
CBeepButtonクラスでは、WM_LBUTTONDOWNメッセージハンドラで
MessageBeep()を呼び出してビープ音を鳴らします。
また、SetMsgHandled(false)を呼び出すことによって、
ビープ音を鳴らす以外は通常の動作をさせます。
ところで、このCBeepButtonクラス自体はCWindowImplから派生した通常のウィンドウであり、
ボタンコントロールに基づいたものではありません。
ボタンコントロールに基づいたビープボタンを作成するためには、
引数にボタンコントロールのハンドルを指定してSubclassWindow()を呼び出します。
CBeepButton m_button_beep;
...
BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){
...
...
m_button_beep.SubclassWindow(既存のボタンコントロールのハンドル);
}
|
このように、スーパークラス化ではDECLARE_WND_SUPERCLASSマクロを使って「クラス」に対して基になるコントロールを指定しますが、
サブクラス化ではSubclassWindow()を使って「インスタンス」に対して基になるコントロールを指定します。
次に示すのは、このCBeepButtonクラスを使用する例です。
// 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 };
CBeepButton m_button_beep;
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>)
END_MSG_MAP()
BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){
AtlCreateEmptyMenuBar(m_hWnd);
// コントロールサブクラス化
m_button_beep.SubclassWindow(GetDlgItem(IDC_BUTTON_BEEP));
// メッセージループにメッセージフィルタとアイドルハンドラを追加
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 "BeepButton.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］を次のように指定します。
| コントロール名 |
ID |
Caption |
| ボタン |
IDC_BUTTON_BEEP |
ビープボタン |
次に、CSampleProjectDialogクラスでビープボタン用に
CBeepButtonクラスのインスタンスをメンバ変数として宣言します。
これを使うためには、WM_INITDIALOGメッセージハンドラでSubclassWindow()を呼び出します。
最後に、SampleProject.cppファイルでSampleProjectDialog.hヘッダの前にBeepButton.hヘッダをインクルードします。
|
