コンテインドウィンドウ

ホーム

WTL Mobile

コンテインドウィンドウ

ドキュメント種別	ATL/WTL に関する文書
最終更新日	2009/11/28
PR

　コンテインドウィンドウは、受け取ったすべてのメッセージを自分のコンテナウィンドウに渡します。一般に、コンテナウィンドウは親ウィンドウで、コンテインドウィンドウはその子ウィンドウですが、異なる場合もあります。コンテナウィンドウクラスは、コンテインドウィンドウクラスのインスタンスをメンバ変数として持ちます。

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

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

typedef CContainedWindowT<CWindow>  CContainedWindow;

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

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

// コンテナウィンドウ
class CSampleProjectDialog : public ...
{
public:
    enum { IDD = IDD_MAINDLG };

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

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

    ...
    ...

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

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

class CSampleProjectDialog : public ...
{
    ...
    ...

    // メッセージマップ
    BEGIN_MSG_MAP_EX(CSampleProjectDialog)
        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 CSampleProjectDialog : public ...
{
    ...
    ...

    enum { IDC_BUTTON_BEEP = 1200 };

    BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){

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

        return TRUE;
    }

    ...
    ...

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

    CContainedWindow m_contained;

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

    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_EX(CSampleProjectDialog)
        MSG_WM_INITDIALOG(OnInitDialog)
        MSG_WM_DESTROY(OnDestroy)
        CHAIN_MSG_MAP(CUpdateUI<CSampleProjectDialog>)
        CHAIN_MSG_MAP(CAppStdDialogImpl<CSampleProjectDialog>)
    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){
        AtlCreateEmptyMenuBar(m_hWnd);

        // コントロールサブクラス化
        m_contained.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 "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クラスでビープボタン用に CContainedWindowクラスのインスタンスをメンバ変数として宣言します。これはCSampleProjectDialogクラスのコンストラクタで初期化します。

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