ホーム WTL Mobile
アクセラレータ
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2009/06/10
PR
 WTLではアクセラレータをCAcceleratorTというクラステンプレートでカプセル化しています。 テンプレート引数はbool値で、trueの場合はデストラクタでDestroyAcceleratorTable()を呼び出し、 falseの場合は呼び出しません。atluser.hヘッダではtypedefによって次のように宣言されています。

// atluser.h
typedef CAcceleratorT<false>  CAcceleratorHandle;
typedef CAcceleratorT<true>   CAccelerator;
			

以下に示すのは、CAcceleratorクラスを使用してアクセラレータを設定する例です。 [Ctrl]+[M]キーを押すとメッセージボックスを表示します。

プロジェクトファイル ダウンロード
// 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>
#include <atlmisc.h>
			

// MainWindow.h
#pragma once

class CMainWindow : public CWindowImpl<CMainWindow>,
    public CMessageFilter, public CIdleHandler
{
public:
    DECLARE_WND_CLASS(_T("SampleProject"));

    CAccelerator m_acc;    // アクセラレータ

    virtual BOOL PreTranslateMessage(MSG* pMsg){
        // アクセラレータ処理
        if(!m_acc.IsNull() && m_acc.TranslateAccelerator(m_hWnd, pMsg))
            return TRUE;

        return FALSE;
    }

    virtual BOOL OnIdle(){
        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)
        COMMAND_ID_HANDLER_EX(ID_ACCEL_MESSAGE, OnAccelMessage)
    END_MSG_MAP()

    void OnPaint(CDCHandle /*dc*/){
        CPaintDC dc(m_hWnd);
        CRect rect;
        GetClientRect(rect);
        dc.DrawText(_T("Hello, ATL/WTL"), -1,
            rect, DT_SINGLELINE | DT_CENTER | DT_VCENTER);
    }

    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){
        // アクセラレータリソース読み込み
        m_acc.LoadAccelerators(IDR_MAINFRAME);

        // メッセージループにメッセージフィルタとアイドルハンドラを追加
        CMessageLoop* pLoop = _Module.GetMessageLoop();
        pLoop->AddMessageFilter(this);
        pLoop->AddIdleHandler(this);
        return 0;
    }

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

    void OnAccelMessage(UINT uNotifyCode, int nID, CWindow wndCtl){
        MessageBox(_T("Hello, Accelerator"));
    }
};
			

// SampleProject.cpp
#include "stdafx.h"
#include "resource.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;
}
			

 まず、プロジェクトにアクセラレータリソースを追加し、 [ID]と[キー]を次のように設定します。

リソース名 ID キー
アクセラレータ IDR_MAINFRAME -
アクセラレータキー ID_ACCEL_MESSAGE [Ctrl]+[M]



 次に、CMainWindowクラスでは、CAcceleratorクラスのインスタンスをメンバ変数として宣言します。 WM_CREATEメッセージハンドラではLoadAccelerators()を呼び出してアクセラレータリソースを読み込みます。

 次に、メッセージフィルタ処理を行うPreTranslateMessage()TranslateAccelerator()を呼び出し、アクセラレータキーを処理する機会を与えます。

 次に、リソースIDがID_ACCEL_MESSAGEWM_COMMANDメッセージハンドラとしてOnAccelMessage()を追加します。 このハンドラ関数ではメッセージボックスを表示します。

 最後に、SampleProject.cppでresource.hをインクルードします。

 これにより、[Ctrl]+[M]キーを押すとOnAccelMessage()が呼び出されます。