ホーム ATL/WTL
シンプルリバー
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2007/09/24
PR
 ここでは、前回のツールバーを追加したプログラムにリバーを追加し、 そのリバーのバンドにツールバーを格納します。 CFrameWindowImplクラステンプレートには簡単なリバーを作成するために CreateSimpleReBar()というメンバ関数が用意されています。


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

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

#include <atlcrack.h>
#include <atlmisc.h>
#include <atlframe.h>
			

// MainWindow.h
#pragma once

class CMainWindow : public CFrameWindowImpl<CMainWindow>,
    public CMessageFilter, public CIdleHandler
{
public:
    // ウィンドウクラス名、共通リソースID、スタイル、背景色を登録
    DECLARE_FRAME_WND_CLASS_EX(_T("Hello"), IDR_MAINFRAME,
        CS_HREDRAW | CS_VREDRAW | CS_DBLCLKS, COLOR_WINDOW)

    virtual BOOL PreTranslateMessage(MSG* pMsg){
        return CFrameWindowImpl<CMainWindow>::PreTranslateMessage(pMsg);
    }

    virtual BOOL OnIdle(){
        return FALSE;
    }

    BEGIN_MSG_MAP(CMainWindow)
        MSG_WM_PAINT(OnPaint)
        MSG_WM_CREATE(OnCreate)
        MSG_WM_DESTROY(OnDestroy)
        COMMAND_ID_HANDLER_EX(ID_APP_ABOUT, OnAbout)
        COMMAND_ID_HANDLER_EX(ID_APP_EXIT, OnFileExit)
        CHAIN_MSG_MAP(CFrameWindowImpl<CMainWindow>)  // CFrameWindowImplへチェイン
    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);
    }

    int OnCreate(LPCREATESTRUCT lpCreateStruct){
        // リバーを作成
        CreateSimpleReBar();

        // ツールバーを作成してバンドに追加
        HWND hWndToolBar = CreateSimpleToolBarCtrl(m_hWnd,
            IDR_MAINFRAME, FALSE, ATL_SIMPLE_TOOLBAR_PANE_STYLE);
        AddSimpleReBarBand(hWndToolBar);

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

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

    void OnAbout(UINT uNotifyCode, int nID, CWindow wndCtl){
        MessageBox(_T("ATL/WTLプログラミング 第2版"));
    }

    void OnFileExit(UINT uNotifyCode, int nID, CWindow wndCtl){
        PostMessage(WM_CLOSE);
    }
};
			

// 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);

    // コモンコントロール及びリバー初期化
    AtlInitCommonControls(ICC_WIN95_CLASSES | ICC_COOL_CLASSES);

    _Module.Init(NULL, hInstance);

    CMessageLoop theLoop;
    _Module.AddMessageLoop(&theLoop);

    CMainWindow wnd;
    wnd.CreateEx();
    wnd.ShowWindow(nCmdShow);
    wnd.UpdateWindow();

    int nRet = theLoop.Run();

    _Module.RemoveMessageLoop();

    _Module.Term();

    return nRet;
}
			

 まず、CMainWindowクラスのWM_CREATEメッセージハンドラで、 CreateSimpleReBar()を呼び出してリバーを作成します。

なお、CreateSimpleReBar()には2つの引数を渡すことができます。 第1引数にはリバーのスタイルを指定します。デフォルト引数はATL_SIMPLE_REBAR_STYLEです。 リバーのスタイルはatlframe.hヘッダで次のように定義されています。なお、表示上の都合で改行位置などを変更しています。

// atlframe.h
// standard rebar styles
#if (_WIN32_IE >= 0x0400)
#define ATL_SIMPLE_REBAR_STYLE \
    (WS_CHILD | WS_VISIBLE | WS_BORDER | WS_CLIPCHILDREN | WS_CLIPSIBLINGS | \
    RBS_VARHEIGHT | RBS_BANDBORDERS | RBS_AUTOSIZE)
#else
#define ATL_SIMPLE_REBAR_STYLE \
    (WS_CHILD | WS_VISIBLE | WS_BORDER | WS_CLIPCHILDREN | WS_CLIPSIBLINGS | \
    RBS_VARHEIGHT | RBS_BANDBORDERS)
#endif //!(_WIN32_IE >= 0x0400)

// rebar without borders
#if (_WIN32_IE >= 0x0400)
#define ATL_SIMPLE_REBAR_NOBORDER_STYLE \
    (WS_CHILD | WS_VISIBLE | WS_CLIPCHILDREN | WS_CLIPSIBLINGS | \
    RBS_VARHEIGHT | RBS_BANDBORDERS | RBS_AUTOSIZE | CCS_NODIVIDER)
#else
#define ATL_SIMPLE_REBAR_NOBORDER_STYLE \
    (WS_CHILD | WS_VISIBLE | WS_CLIPCHILDREN | WS_CLIPSIBLINGS | \
    RBS_VARHEIGHT | RBS_BANDBORDERS | CCS_NODIVIDER)
#endif //!(_WIN32_IE >= 0x0400)
			

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

CreateSimpleReBar()は、内部でCreateSimpleReBarCtrl()というメンバ関数を呼び出しており、 その呼び出しによって得られたリバーのハンドルを、 CFrameWindowImplクラスの基底クラスであるCFrameWindowImplBasem_hWndToolBarというHWND型のメンバ変数に代入します。 フレームウィンドウはリバーに対する操作を、このm_hWndToolBarで識別されるハンドルに対して行います。

 次に、CreateSimpleToolBarCtrl()を呼び出してツールバーを作成します。 CreateSimpleToolBarCtrl()の第1引数はメインウィンドウのハンドル、 第2引数はリソースID、第3引数はツールバーの先頭にセパレータを設定するかどうかのフラグ、 第4引数にはツールバーのスタイルを指定します。第5引数には識別子を指定できますが、 今回は省略します。 リバーへバンドするツールバーの場合は、スタイルとしてATL_SIMPLE_TOOLBAR_PANE_STYLE を指定します。このスタイルはatlframe.hヘッダで次のように定義されています。

// atlframe.h
// toolbar in a rebar pane
#define ATL_SIMPLE_TOOLBAR_PANE_STYLE \
    (WS_CHILD | WS_VISIBLE | WS_CLIPCHILDREN | WS_CLIPSIBLINGS | \
    CCS_NODIVIDER | CCS_NORESIZE | CCS_NOPARENTALIGN | TBSTYLE_TOOLTIPS | TBSTYLE_FLAT)
			

 次に、AddSimpleReBarBand()を呼び出して、ツールバーをリバーのバンドに追加します。 今回は第1引数としてツールバーのハンドルしか指定しませんが、 第2引数にはタイトル、第3引数には新しい行に置くかどうかのフラグ、 第4引数には幅、第5引数には幅より小さくできるようにするかどうかのフラグを設定できます。

 _tWinMain()では、リバーを初期化するためにICC_COOL_CLASSESフラグを指定して AtlInitCommonControls()を呼び出します。 AtlInitCommonControls()はWin32APIのInitCommonControlsEx()関数をラップします。 今回は、よく使用されると思われるICC_WIN95_CLASSESフラグも追加しました。