ホーム WTL Mobile
タブ
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2010/02/13
PR
 WTLはタブコントロールをベースとしたビューウィンドウを作成するためにCTabViewImplというクラステンプレートを用意していますが、 Windows Mobile 用にはCTabViewImplから派生したCBottomTabViewImplクラステンプレートを用意しています。 これはATLのCWindowImplクラステンプレートのように基底クラスとしてのみ使用し、 テンプレート引数の種類もCWindowImplと同じです。 atlwince.hヘッダではCBottomTabViewImplから派生したCBottomTabViewクラスが定義されています。

// atlwince.h
class CBottomTabView : public CBottomTabViewImpl<CBottomTabView>
{
    ...
    ...
			

 以下に示すのは、CBottomTabViewクラスを使用する例です。 メニューの[新規作成]を実行すると新しいタブが追加され、 [閉じる]を実行するとアクティブなタブ(選択されているタブ)が削除されます。 [すべてのタブを閉じる]を実行するとすべてのタブが削除されます。 各タブには通常のウィンドウを表示します。


プロジェクトファイル ダウンロード
// 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>
#include <atlctrlx.h>   // CTabViewImplを使用するため
#define _WTL_CE_NO_ZOOMSCROLL
#define _WTL_CE_NO_FULLSCREEN
#include <atlwince.h>
			

// TabPage.h
#pragma once

class CTabPage : public CWindowImpl<CTabPage>
{
public:
    virtual void OnFinalMessage(HWND /*hWnd*/){
        delete this;
    }

    BEGIN_MSG_MAP(CTabPage)
        MSG_WM_PAINT(OnPaint)
    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);
    }
};
			

// SampleProjectFrame.h
#pragma once

class CSampleProjectFrame : 
    public CFrameWindowImpl<CSampleProjectFrame>,
    public CUpdateUI<CSampleProjectFrame>,
    public CAppWindow<CSampleProjectFrame>,
    public CMessageFilter, public CIdleHandler
{
public:
    DECLARE_APP_FRAME_CLASS(NULL, IDR_MAINFRAME, L"Software\\WTL")

    CBottomTabView m_view;

    virtual BOOL PreTranslateMessage(MSG* pMsg){
        if(CFrameWindowImpl<CSampleProjectFrame>::PreTranslateMessage(pMsg))
            return TRUE;

        return m_view.IsWindow() ? m_view.PreTranslateMessage(pMsg) : FALSE;
    }

    virtual BOOL OnIdle(){
        return FALSE;
    }

    BEGIN_UPDATE_UI_MAP(CSampleProjectFrame)
    END_UPDATE_UI_MAP()

    BEGIN_MSG_MAP(CSampleProjectFrame)
        MSG_WM_CREATE(OnCreate)
        MSG_WM_DESTROY(OnDestroy)
        COMMAND_ID_HANDLER_EX(ID_FILE_NEW, OnFileNew)
        COMMAND_ID_HANDLER_EX(ID_FILE_CLOSE, OnFileClose)
        COMMAND_ID_HANDLER_EX(ID_WINDOW_CLOSE, OnWindowClose)
        COMMAND_RANGE_HANDLER_EX(ID_WINDOW_TABFIRST, ID_WINDOW_TABLAST, OnWindowTab)
        COMMAND_ID_HANDLER_EX(ID_APP_EXIT, OnAppExit)
        CHAIN_MSG_MAP(CAppWindow<CSampleProjectFrame>)
        CHAIN_MSG_MAP(CUpdateUI<CSampleProjectFrame>)
        CHAIN_MSG_MAP(CFrameWindowImpl<CSampleProjectFrame>)
    END_MSG_MAP()

    int OnCreate(LPCREATESTRUCT lpCreateStruct){
        // メニューバー作成
        CreateSimpleCEMenuBar(IDR_MAINFRAME, SHCMBF_HMENU);

        // ビューを作成
        m_hWndClient = m_view.Create(m_hWnd, rcDefault, NULL,
            WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN);

        // [ウィンドウ]メニュー設定
        TBBUTTON tbb = {0};
        ::SendMessage(m_hWndCECommandBar, TB_GETBUTTON, 1, (LPARAM)&tbb);
        CMenuHandle menuMain = (HMENU)tbb.dwData;
        m_view.SetWindowMenu(menuMain.GetSubMenu(2));

        // メッセージループにメッセージフィルタとアイドルハンドラを追加
        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 OnFileNew(UINT uNotifyCode, int nID, CWindow wndCtl){
        CTabPage* pView = new CTabPage;
        pView->Create(m_view, rcDefault, NULL, 
            WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN);
        m_view.AddPage(pView->m_hWnd, _T("Document"));
    }

    void OnFileClose(UINT uNotifyCode, int nID, CWindow wndCtl){
        int nActivePage = m_view.GetActivePage();
        if(nActivePage != -1)
            m_view.RemovePage(nActivePage);
    }

    void OnWindowClose(UINT uNotifyCode, int nID, CWindow wndCtl){
        m_view.RemoveAllPages();
    }

    void OnWindowTab(UINT uNotifyCode, int nID, CWindow wndCtl){
        int nPage = nID - ID_WINDOW_TABFIRST;
        m_view.SetActivePage(nPage);
    }

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

// SampleProject.cpp
#include "stdafx.h"
#include "resourceppc.h"
#include "TabPage.h"
#include "SampleProjectFrame.h"

CAppModule _Module;

int WINAPI _tWinMain(HINSTANCE hInstance,
    HINSTANCE /*hPrevInstance*/, LPTSTR lpstrCmdLine, int nCmdShow)
{
    HRESULT hRes =
        CSampleProjectFrame::ActivatePreviousInstance(hInstance, lpstrCmdLine);

    if(FAILED(hRes) || S_FALSE == hRes){
        return hRes;
    }

    hRes = ::CoInitializeEx(NULL, COINIT_MULTITHREADED);
    ATLASSERT(SUCCEEDED(hRes));

    AtlInitCommonControls(ICC_TAB_CLASSES);
    SHInitExtraControls();

    hRes = _Module.Init(NULL, hInstance);
    ATLASSERT(SUCCEEDED(hRes));

    int nRet = CSampleProjectFrame::AppRun(lpstrCmdLine, nCmdShow);

    _Module.Term();
    ::CoUninitialize();

    return nRet;
}
			

 まず、プロジェクトにメニューリソースを追加し、[ID]と[Caption]を次のように設定します。

リソース名 ID Caption
メニュー IDR_MAINFRAME -
メニューアイテム(トップレベル) ID_APP_EXIT 終了
メニューアイテム(トップレベル) - ファイル
メニューアイテム ID_FILE_NEW 新規作成
メニューアイテム ID_FILE_CLOSE 閉じる
メニューアイテム - ウィンドウ
メニューアイテム ID_WINDOW_CLOSE すべてのタブを閉じる



 次に、stdafx.hヘッダでは、CBottomTabViewImplの基底クラスであるCTabViewImplを使用するためにatlctrlx.hヘッダをインクルードします。

 次に、プロジェクトにTabPage.hというヘッダファイルを追加し、 そこにCWindowImplから派生したCTabPageというクラスを定義します。 このクラスは各タブに表示する通常のウィンドウです。

 次に、CBottomTabViewクラスのインスタンスを CSampleProjectFrameクラスのメンバ変数として宣言し、 WM_CREATEメッセージハンドラでCreate()を呼び出してビューウィンドウを作成します。

WM_CREATEメッセージハンドラでは、SetWindowMenu()を呼び出して[ウィンドウ]メニューアイテムのハンドルをタブビューに設定します。 これにより、タブが追加された際に[ウィンドウ]メニューアイテム以下にタブ名がリストされます。 リストされたアイテムにはID_WINDOW_TABFIRSTからID_WINDOW_TABLASTの範囲のリソースIDが割り当てられます。



 次に、リソースIDがID_FILE_NEWWM_COMMANDメッセージハンドラとして OnFileNew()を追加します。 このハンドラ関数ではタブビューを親としてタブに表示するウィンドウを作成し、 AddPage()を呼び出してタブを追加します。

 次に、リソースIDがID_FILE_CLOSEWM_COMMANDメッセージハンドラとして、 OnFileClose()を追加します。 このハンドラ関数ではGetActivePage()を呼び出してアクティブなタブを取得し、 RemovePage()を呼び出してそのタブを削除します。

 次に、リソースIDがID_WINDOW_CLOSEWM_COMMANDメッセージハンドラとして、 OnWindowClose()を追加します。 このハンドラ関数ではRemoveAllPages()を呼び出してすべてのタブを削除します。

 次に、リソースIDがID_WINDOW_TABFIRSTからID_WINDOW_TABLASTの範囲のWM_COMMANDメッセージハンドラとして、 OnWindowTab()を追加します。 このハンドラ関数は[ウィンドウ]メニューアイテムにリストされたタブ名を実行すると呼び出されます。 今回の例ではSetActivePage()を呼び出してタブをアクティブにします。

 最後に、SampleProject.cppファイルでSampleProjectFrame.hヘッダの前にTabPage.hヘッダをインクルードし、 _tWinMain()で、引数にICC_TAB_CLASSESを指定してAtlInitCommonControls()を呼び出します。