ホーム ATL/WTL
シンプルツールバー
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2004/10/02
PR
 今回は、これまで作成した「Hello, ATL/WTL」プログラムにツールバーを追加します。 CFrameWindowImplクラスには簡単なツールバーを作成するために CreateSimpleToolBar()というメンバ関数が用意されています。


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

#include <atlcrack.h>
#include <atlmisc.h>
#include <atlframe.h> // CFrameWindowImplクラスを使用するため
			

// MainWindow.h内
// メインウィンドウの基底クラスをCFrameWindowImplに変更
class CMyWindow : public CFrameWindowImpl<CMyWindow>,
    public CMessageFilter, public CIdleHandler
{
public:
    // ウィンドウクラス名、共通リソースID、スタイル、背景色を登録
    DECLARE_FRAME_WND_CLASS_EX(_T("Hello"), IDR_MAINFRAME,
        CS_HREDRAW | CS_VREDRAW | CS_DBLCLKS, COLOR_WINDOW)

private:
    // メッセージフィルタ処理
    virtual BOOL PreTranslateMessage(MSG* pMsg){
        // 基底クラスのPreTranslateMessageを呼び出す
        return CFrameWindowImpl<CMyWindow>::PreTranslateMessage(pMsg);
    }

    // アイドル処理
    virtual BOOL OnIdle(){
        return FALSE;
    }

    // メッセージマップ
    BEGIN_MSG_MAP_EX(CMyWindow)
        MSG_WM_PAINT(OnPaint)
        MSG_WM_CONTEXTMENU(OnContextMenu)
        MSG_WM_CREATE(OnCreate)
        COMMAND_ID_HANDLER_EX(ID_MENUITEM_HELLO, OnMenuHello)
        COMMAND_ID_HANDLER_EX(ID_MENUITEM_EXIT, OnMenuExit)
        CHAIN_MSG_MAP(CFrameWindowImpl<CMyWindow>)  // CFrameWindowImplクラスへチェーン
    END_MSG_MAP()

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

    void OnContextMenu(HWND hWnd, CPoint pt){
        // [Shift]+[F10]キーが押された場合は座標をクライアント領域の左上に設定
        if(pt.x == -1 && pt.y == -1){
            pt.SetPoint(0, 0);
            ClientToScreen(&pt);
        }

        // 座標がクライアント領域内の場合のみポップアップメニューを表示
        CRect rc;
        GetClientRect(&rc);
        ClientToScreen(&rc);
        if(rc.PtInRect(pt)){
            CMenu menuPopup;
            menuPopup.LoadMenu(IDR_MENU_POPUP);
            menuPopup.GetSubMenu(0).TrackPopupMenu(
                TPM_LEFTALIGN | TPM_TOPALIGN | TPM_LEFTBUTTON, pt.x, pt.y, m_hWnd);
        }else{
            SetMsgHandled(false);
        }
    }

    LRESULT OnCreate(LPCREATESTRUCT lpcs){
        // ツールバーを作成
        CreateSimpleToolBar();

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

    void OnMenuHello(UINT uNotifyCode, int nID, HWND hWndCtl){
        MessageBox(_T("Hello, ATL/WTL"));
    }

    void OnMenuExit(UINT uNotifyCode, int nID, HWND hWndCtl){
        PostMessage(WM_CLOSE);
    }
};
			

// hello.cpp内
#include "stdafx.h"

#include "resource.h"

#include "MainWindow.h"

CAppModule _Module;

int WINAPI _tWinMain(HINSTANCE hInstance, HINSTANCE, LPTSTR lpCmdLine, int nCmdShow)
{
    _Module.Init(NULL, hInstance);

    CMessageLoop theLoop;
    _Module.AddMessageLoop(&theLoop);

    // 独自ウィンドウを作成
    CMyWindow wnd;
    wnd.CreateEx();
    wnd.ShowWindow(nCmdShow);
    wnd.UpdateWindow();

    int nRet = theLoop.Run();

    _Module.RemoveMessageLoop();

    _Module.Term();

    return nRet;
}
			

 まずはプロジェクトにツールバーリソースを追加し、リソースIDとしてIDR_MAINFRAMEを設定します。 そしてツールバーにボタンを一つ追加し、そのボタンにID_MENUITEM_HELLOというリソースIDを設定します。 これはすでにポップアップメニューを作成した時に使用しているIDです。



 次に、CMyWindowクラスのOnCreate()内で、 CreateSimpleToolBar()を呼び出します。 これだけで、メインウィンドウにツールバーが追加され、 ツールバー上のボタン(ID:ID_MENUITEM_HELLO)を押すと、 OnMenuHello()が呼び出されるようになります。

なお、CreateSimpleToolBar()には3つの引数を渡すことができます。 第1引数にはツールバーリソースIDを指定します。デフォルト引数は 0 で、 この場合は共通リソースID(今回の例ではIDR_MAINFRAME)が使用されます。 第2引数にはツールバーのスタイルを指定します。デフォルト引数はATL_SIMPLE_TOOLBAR_STYLEで、 これはatlframe.hヘッダで次のように定義されています。

// atlframe.h内
#define ATL_SIMPLE_TOOLBAR_STYLE \
    (WS_CHILD | WS_VISIBLE | WS_CLIPCHILDREN | WS_CLIPSIBLINGS | TBSTYLE_TOOLTIPS)
			

第3引数には識別子を指定します。デフォルト引数はATL_IDW_TOOLBARです。

CreateSimpleToolBar()は、内部でCreateSimpleToolBarCtrl()というメンバ関数を呼び出しており、 その呼び出しによって得られたツールバーのハンドルを、 CFrameWindowImplクラスの基底クラスであるCFrameWindowImplBase クラスのm_hWndToolBarというHWND型のメンバ変数に代入しています。

CFrameWindowImplBaseクラスにはTTN_GETDISPINFOATTN_GETDISPINFOWメッセージハンドラが用意されています。 このため、ツールバーのボタン上にカーソルを乗せたときのTTN_GETDISPINFOA(W)メッセージが チェーン先のCFrameWindowImplクラスに送られると、 自動的にツールバーリソースの[プロンプト]で設定した文字列が、ツールチップとして表示されます。