ホーム ATL/WTL
コンテインドウィンドウ
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2007/03/18
PR
 コンテインドウィンドウは、受け取ったすべてのメッセージを自分のコンテナウィンドウに渡します。 一般に、コンテナウィンドウは親ウィンドウで、コンテインドウィンドウはその子ウィンドウですが、 そうでない場合もあります。 コンテナウィンドウクラスは、コンテインドウィンドウクラスのインスタンスをメンバ変数として持ちます。

 ATLではコンテインドウィンドウをCContainedWindowTというクラステンプレートでカプセル化しています。 atlwin.hヘッダでは次のように定義されています。

// atlwin.h
template <class TBase /* = CWindow */, class TWinTraits /* = CControlWinTraits */>
class CContainedWindowT : public TBase
{
     ...
}

typedef CContainedWindowT<CWindow>  CContainedWindow;
			

これは、CContainedWindowCWindowの派生クラスであることを意味します。

コンテインドウィンドウは、コントロールなどの定義済みウィンドウクラス ("BUTTON"や"SysListView32"など)を基にします。 次に示すのは、ダイアログをコンテナウィンドウとし、ボタンコントロールを基にコンテインドウィンドウを作成する例です。

// コンテナウィンドウ
class CMainDlg : public CDialogImpl<CMainDlg>
{
public:
    enum { IDD = IDD_MAINDLG };

    CContainedWindow m_contained;  // コンテインドウィンドウ

    // コンストラクタ
    CMainDlg() : m_contained(_T("BUTTON"), this, 100)
    {}

    ...
    ...
			

 まず、コンテインドウィンドウのインスタンスをコンテナウィンドウクラス (今回の例ではCMainDlgクラス)のメンバ変数として宣言し、 コンテナウィンドウのコンストラクタで初期化します。 第1引数には定義済みウィンドウクラス名、第2引数にはメッセージを処理するウィンドウへのポインタ、 第3引数にはメッセージを処理する代替メッセージマップの番号を指定します。

今回の例では、メッセージを処理する代替メッセージマップの番号を100に指定します。 したがって、CMainDlgクラスのメッセージマップは次のようになります。 なお、代替メッセージマップでWTLのメッセージマクロを使用する場合、 メッセージマップマクロにはBEGIN_MSG_MAP_EXを使用する必要があります。

class CMainDlg : public CDialogImpl<CMainDlg>
{
    ...
    ...

    // メッセージマップ
    BEGIN_MSG_MAP_EX(CMainDlg)
        MSG_WM_INITDIALOG(OnInitDialog)
        ...
        ...
    ALT_MSG_MAP(100)  // コンテインドウィンドウ用代替メッセージマップ
        MSG_WM_LBUTTONDOWN(OnLButtonDownForContained)
    END_MSG_MAP()

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

    ...
    ...
			

これにより、コンテインドウィンドウのメッセージは番号100の代替メッセージマップで処理されます。 今回の例では、コンテインドウィンドウを左クリックすると、 OnLButtonDownForContained()が呼び出されます。

最後に、コンテインドウィンドウを作成する必要があります。 ウィンドウを作成するためにはCreate()を呼び出しますが、 SubclassWindow()を呼び出して既存のコントロールをサブクラス化することもできます。

class CMainDlg : public CDialogImpl<CMainDlg>
{
    ...
    ...

    enum { IDC_BUTTON_BEEP = 1001 };

    BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){

        // コントロール作成
        m_contained.Create(m_hWnd, CRect(0, 0, 200, 30),
            _T("ビープボタン"), WS_CHILD | WS_VISIBLE, 0, IDC_BUTTON_BEEP);
        // または既存のコントロールをサブクラス化
        // m_contained.SubclassWindow(GetDlgItem(IDC_BUTTON_BEEP));

        return TRUE;
    }

    ...
    ...
			

このように、コンテインドウィンドウを使用すると、 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 };

    CContainedWindow m_contained;

    // コンストラクタ
    CMainDlg() : m_contained(_T("BUTTON"), this, 100)
    {}

    BEGIN_MSG_MAP_EX(CMainDlg)
        MSG_WM_INITDIALOG(OnInitDialog)
        COMMAND_ID_HANDLER_EX(IDOK, OnOK)
        COMMAND_ID_HANDLER_EX(IDCANCEL, OnCancel)
    ALT_MSG_MAP(100)
        MSG_WM_LBUTTONDOWN(OnLButtonDownForContained)
    END_MSG_MAP()

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

    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_contained.SubclassWindow(GetDlgItem(IDC_BUTTON_BEEP));

        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 "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;
}
			

 まず、リソースを作成します。ダイアログにボタンコントロールを配置し、 [Caption]と[ID]を次のように指定します。

コントロール名 Caption ID
ボタン ビープボタン IDC_BUTTON_BEEP

 次に、CMainDlgクラスでビープボタン用に CContainedWindowクラスのインスタンスをメンバ変数として宣言します。 これはCMainDlgクラスのコンストラクタで初期化します。

 次に、コンテインドウィンドウ用の代替メッセージマップとメッセージハンドラを用意し、 最後にWM_INITDIALOGメッセージハンドラでSubclassWindow()を呼び出して 既存のボタンコントロールをサブクラス化します。