ホーム WTL Mobile
メッセージフィルタ
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2009/05/02
PR >
 メッセージループにCMessageLoopクラスを使用すると、CMessageFilterクラスを使って メッセージフィルタを追加することができます。 メッセージフィルタを追加すると、CMessageLoopクラス内のメッセージループで ::TranslateMessage()が呼び出される前に何か処理をさせることができます。

以下に示すのは、このCMessageFilterクラスを使って、 前回のメッセージループを変更したプログラムにメッセージフィルタを追加する例です。

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

#define WINVER _WIN32_WCE
#define _SECURE_ATL 1

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

#include <aygshell.h>
#pragma comment(lib, "aygshell.lib")

#include <atlcrack.h> // WTLメッセージクラッカーを使うため
			

// MainWindow.h
#pragma once

// 基底クラスにCMessageFilterを追加
class CMainWindow : public CWindowImpl<CMainWindow>, public CMessageFilter
{
public:
    DECLARE_WND_CLASS(_T("SampleProject"));

    // メッセージフィルタ処理
    virtual BOOL PreTranslateMessage(MSG* pMsg){
        return FALSE;
    }

    // メッセージマップ
    BEGIN_MSG_MAP(CMainWindow)
        MSG_WM_PAINT(OnPaint)
        MSG_WM_ACTIVATE(OnActivate)
        MSG_WM_SETTINGCHANGE(OnSettingChange)
        MSG_WM_CREATE(OnCreate)
        MSG_WM_DESTROY(OnDestroy)
    END_MSG_MAP()

    void OnPaint(CDCHandle /*dc*/){
        PAINTSTRUCT ps;
        HDC hDC = BeginPaint(&ps);
        RECT rect;
        GetClientRect(&rect);
        DrawText(hDC, _T("Hello, ATL/WTL"),
            -1, &rect, DT_SINGLELINE | DT_CENTER | DT_VCENTER);
        EndPaint(&ps);
    }

    void OnActivate(UINT nState, BOOL bMinimized, CWindow wndOther){
        SHFullScreen(m_hWnd, SHFS_HIDESIPBUTTON);
    }

    void OnSettingChange(UINT uFlags, LPCTSTR lpszSection){
        SHFullScreen(m_hWnd, SHFS_HIDESIPBUTTON);
    }

    int OnCreate(LPCREATESTRUCT lpCreateStruct){
        // メッセージループにメッセージフィルタを追加
        CMessageLoop* pLoop = _Module.GetMessageLoop();
        pLoop->AddMessageFilter(this);
        return 0;
    }

    void OnDestroy(){
        // メッセージループからメッセージフィルタを削除
        CMessageLoop* pLoop = _Module.GetMessageLoop();
        pLoop->RemoveMessageFilter(this);
        PostQuitMessage(0);
    }
};
			

// SampleProject.cpp
#include "stdafx.h"
#include "MainWindow.h"

CAppModule _Module;

int APIENTRY _tWinMain(HINSTANCE hInstance, 
                       HINSTANCE hPrevInstance, 
                       LPTSTR    lpCmdLine, 
                       int       nCmdShow)
{
    UNREFERENCED_PARAMETER(hPrevInstance);
    UNREFERENCED_PARAMETER(lpCmdLine);

    TCHAR szAppName[] = _T("SampleProject");

    HWND hWnd = FindWindow(szAppName, szAppName);    
    if(hWnd){
        SetForegroundWindow((HWND)((ULONG) hWnd | 0x00000001));
        return 0;
    }

    _Module.Init(NULL, hInstance);

    CMessageLoop theLoop;
    _Module.AddMessageLoop(&theLoop);

    CMainWindow wnd;
    wnd.Create(NULL, CWindow::rcDefault, szAppName, WS_OVERLAPPEDWINDOW | WS_VISIBLE);

    int nRet = theLoop.Run();

    _Module.RemoveMessageLoop();

    _Module.Term();

    return nRet;
}
			

 CMessageFilterクラスは、メインウィンドウであるCMainWindowクラスの基底クラスとして使用します。 CMessageFilterクラスにはPreTranslateMessage()という純粋仮想関数が 一つあるだけです。

// atlapp.h
class CMessageFilter
{
public:
    virtual BOOL PreTranslateMessage(MSG* pMsg) = 0;
};
			

CMessageFilterクラスの派生クラスであるCMainWindowクラス では、このPreTranslateMessage()を実装します。今回の例ではFALSEを返しているだけですが、 これは何もせずに通常の処理を続けるということを意味します。

 CMainWindowクラスではWM_CREATEメッセージハンドラを追加し、 そこでAddMessageFilter()を呼び出すことによって、メッセージループに このウィンドウ用のメッセージフィルタを追加します。 これにより、CMessageLoopクラス内のメッセージループで ::TranslateMessage()が呼び出される前にCMainWindowクラスで実装した PreTranslateMessage()が呼び出されることになります。

 最後に、WM_DESTROYメッセージハンドラでRemoveMessageFilter()を呼び出すことによって、 メッセージループからメッセージフィルタを削除します。