ホーム WTL Mobile
DocList
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2009/11/18
PR
 DocListコントロールは、Word Mobile や Excel Mobile のようなファイル一覧を表示するコントロールです。

 WTLではDocListコントロールをCDocListCtrlT というクラステンプレートでカプセル化しています。 テンプレート引数にはクラスを指定しますが、 そのクラスはCDocListCtrlTの基底クラスとして使用されます。 atlwince.hヘッダではtypedefによって次のように宣言されています。

// atlwince.h
typedef CDocListCtrlT<ATL::CWindow> CDocListCtrl;
			

これは、CDocListCtrlクラスはCWindowクラスの派生クラスであることを意味します。

 以下に示すのは、CDocListCtrlクラスを使用する例です。 拡張子.hファイルの一覧を表示します。


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

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

    enum { IDC_DOCLIST = 1200 };
    CDocListCtrl m_doc_list;

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

    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)
        CHAIN_MSG_MAP(CAppWindow<CSampleProjectFrame>)
        CHAIN_MSG_MAP(CUpdateUI<CSampleProjectFrame>)
        CHAIN_MSG_MAP(CFrameWindowImpl<CSampleProjectFrame>)
    END_MSG_MAP()

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

        // DocListコントロールを作成
        TCHAR szPath[MAX_PATH];
        SHGetSpecialFolderPath(m_hWnd, szPath, CSIDL_PERSONAL, 0);
        m_hWndClient = m_doc_list.Create(m_hWnd, 
            IDC_DOCLIST, szPath, _T("ヘッダファイル\0*.h\0"));
        m_doc_list.Refresh();

        // メッセージループにメッセージフィルタとアイドルハンドラを追加
        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);
    }
};
			

// SampleProject.cpp
#include "stdafx.h"
#include "resourceppc.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_DATE_CLASSES);
    SHInitExtraControls();

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

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

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

    return nRet;
}
			

 まず、CSampleProjectFrameクラスでは、DocListコントロール用にID(IDC_DOCLIST)を定義し、 CDocListCtrlクラスのインスタンスをメンバ変数として宣言します。

 次に、WM_CREATEメッセージハンドラでは、 Create()を呼び出してDocListコントロールを作成します。 この時、Create()の引数には順に、親ウィンドウハンドル、リソースID、 初期状態で表示するフォルダパス、フィルタ、初期状態で使用するフィルタのインデックス、 DocListコントロールのフラグを指定可能で、第3引数以降は省略可能です。