ホーム ATL/WTL
スーパークラス化
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2007/03/18
PR
 スーパークラス化すると、コントロールなどの定義済みウィンドウクラス("BUTTON"や"SysListView32"など) を拡張した新しいウィンドウクラスを定義できます。

 以下に示すのは、ボタンコントロールをスーパークラス化して、 クリックするとビープ音が鳴るボタン(ビープボタン)を定義する例です。 プロジェクトにBeepButton.hというヘッダファイルを追加し、 そこにCBeepButtonというクラスを定義します。

// BeepButton.h
#pragma once

class CBeepButton : public CWindowImpl<CBeepButton>
{
public:
    DECLARE_WND_SUPERCLASS(_T("BeepButton"), _T("BUTTON"))

    BEGIN_MSG_MAP(CBeepButton)
        MSG_WM_LBUTTONDOWN(OnLButtonDown)
    END_MSG_MAP()

    void OnLButtonDown(UINT nFlags, CPoint point){
        MessageBeep(MB_ICONASTERISK);
        SetMsgHandled(FALSE);
    }
};
			

スーパークラス化するためには、DECLARE_WND_SUPERCLASS()マクロを使います。 このマクロの第1引数にはスーパークラス化した新しいウィンドウクラス名を指定し、 第2引数にはその元となる既存のウィンドウクラス名を指定します。 今回の例ではビープボタンが"BUTTON"ウィンドウクラスに基づくことを意味します。

CBeepButtonクラスでは、WM_LBUTTONDOWNメッセージハンドラで MessageBeep()を呼び出してビープ音を鳴らします。 また、SetMsgHandled(FALSE)を呼び出すことによって、 ビープ音を鳴らす以外は普通のボタンと同じように動作させます。

 次に示すのは、このCBeepButtonクラスを使用する例です。


プロジェクトファイル ダウンロード
// stdafx.h
#pragma once

#include <atlbase.h>
#include <atlapp.h>
extern CAppModule _Module;
#include <atlwin.h>

#include <atlcrack.h>
#include <atlmisc.h>
			

// MainDlg.h
#pragma once

class CMainDlg : public CDialogImpl<CMainDlg>
{
public:
    enum { IDD = IDD_MAINDLG };

    enum { IDC_BUTTON_BEEP = 1001 };
    CBeepButton m_button_beep;

    BEGIN_MSG_MAP(CMainDlg)
        MSG_WM_INITDIALOG(OnInitDialog)
        COMMAND_ID_HANDLER_EX(IDOK, OnOK)
        COMMAND_ID_HANDLER_EX(IDCANCEL, OnCancel)
    END_MSG_MAP()

    BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){
        // スクリーンの中央に配置
        CenterWindow();

        // 大きいアイコン設定
        HICON hIcon = AtlLoadIconImage(IDR_MAINFRAME, LR_DEFAULTCOLOR,
            ::GetSystemMetrics(SM_CXICON), ::GetSystemMetrics(SM_CYICON));
        SetIcon(hIcon, TRUE);
        
        // 小さいアイコン設定
        HICON hIconSmall = AtlLoadIconImage(IDR_MAINFRAME, LR_DEFAULTCOLOR,
            ::GetSystemMetrics(SM_CXSMICON), ::GetSystemMetrics(SM_CYSMICON));
        SetIcon(hIconSmall, FALSE);

        // コントロール作成
        m_button_beep.Create(m_hWnd, CRect(0, 0, 200, 30),
            _T("ビープボタン"), WS_CHILD | WS_VISIBLE, 0, IDC_BUTTON_BEEP);
        m_button_beep.SetFont(GetFont());
        m_button_beep.CenterWindow();

        return TRUE;
    }

    void OnOK(UINT uNotifyCode, int nID, CWindow wndCtl){
        EndDialog(nID);
    }

    void OnCancel(UINT uNotifyCode, int nID, CWindow wndCtl){
        EndDialog(nID);
    }
};
			

// SampleProject.cpp
#include "stdafx.h"
#include "resource.h"
#include "BeepButton.h"
#include "MainDlg.h"

CAppModule _Module;

int WINAPI _tWinMain(HINSTANCE hInstance, 
    HINSTANCE /*hPrevInstance*/, LPTSTR /*lpstrCmdLine*/, int /*nCmdShow*/)
{
    HRESULT hRes = ::CoInitialize(NULL);
    ATLASSERT(SUCCEEDED(hRes));

    ::DefWindowProc(NULL, 0, 0, 0L);

    AtlInitCommonControls(ICC_BAR_CLASSES);

    hRes = _Module.Init(NULL, hInstance);
    ATLASSERT(SUCCEEDED(hRes));

    CMainDlg dlg;
    int nRet = (int) dlg.DoModal();

    _Module.Term();
    ::CoUninitialize();

    return nRet;
}
			

 まず、CMainDlgクラスでビープボタン用に ID(IDC_BUTTON_BEEP)を定義し、 CBeepButtonクラスのインスタンスをメンバ変数として宣言します。

 次に、WM_INITDIALOGメッセージハンドラでCreate()を呼び出してビープボタンを作成し、 フォントを設定してダイアログの中央に配置します。

 最後に、SampleProject.cppファイルでMainDlg.hヘッダの前にBeepButton.hヘッダをインクルードします。

 なお、WTLはDECLARE_FRAME_WND_SUPERCLASSというマクロも用意しています。 これはフレームウィンドウをスーパークラス化します。