チェックリストビュー

ホーム

WTL Mobile

チェックリストビュー

ドキュメント種別	ATL/WTL に関する文書
最終更新日	2009/12/23
PR

　チェックリストビューコントロールは、チェックボックス付きのリストビューコントロールです。 WTLはチェックリストビューコントロールを作成するためにCCheckListViewCtrlというクラスを用意しています。

CCheckListViewCtrlクラスはCListViewCtrlクラスから派生しており、デフォルトでLVS_EX_CHECKBOXESスタイルが設定されています。以下に示すのは、CCheckListViewCtrlクラスを使用する例です。ボタンを押すと、チェックされているアイテムの個数をメッセージボックスで表示します。

	プロジェクトファイルダウンロード

// 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>
#include <atlctrlx.h>  // CCheckListViewCtrlを使用するため

// SampleProjectDialog.h
#pragma once

class CSampleProjectDialog : 
    public CAppStdDialogImpl<CSampleProjectDialog>,
    public CUpdateUI<CSampleProjectDialog>,
    public CMessageFilter, public CIdleHandler
{
public:
    DECLARE_APP_DLG_CLASS(NULL, IDR_MAINFRAME, L"Software\\WTL")

    enum { IDD = IDD_MAINDLG };

    CCheckListViewCtrl m_list_dir;     // チェックリストビュー

    virtual BOOL PreTranslateMessage(MSG* pMsg){
        return CWindow::IsDialogMessage(pMsg);
    }

    virtual BOOL OnIdle(){
        return FALSE;
    }

    BEGIN_UPDATE_UI_MAP(CSampleProjectDialog)
    END_UPDATE_UI_MAP()

    BEGIN_MSG_MAP(CSampleProjectDialog)
        MSG_WM_INITDIALOG(OnInitDialog)
        MSG_WM_DESTROY(OnDestroy)
        COMMAND_ID_HANDLER_EX(IDC_BUTTON_COUNT, OnButtonCount)
        CHAIN_MSG_MAP(CUpdateUI<CSampleProjectDialog>)
        CHAIN_MSG_MAP(CAppStdDialogImpl<CSampleProjectDialog>)
    END_MSG_MAP()

    BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){
        AtlCreateEmptyMenuBar(m_hWnd);

        // コントロール設定
        m_list_dir.SubclassWindow(GetDlgItem(IDC_LIST_DIR));

        // チェックリストビューにカラム設定
        CRect rcList;
        m_list_dir.GetWindowRect(rcList);
        int nScrollWidth = GetSystemMetrics(SM_CXVSCROLL);
        int nBorder = GetSystemMetrics(SM_CXBORDER);
        m_list_dir.InsertColumn(0, _T("名前"), LVCFMT_LEFT,
            rcList.Width() - nScrollWidth - nBorder * 2, -1);

        // アプリケーションがあるフォルダパスを取得
        TCHAR szAppRoot[_MAX_PATH];
        ::GetModuleFileName(NULL, szAppRoot, sizeof(szAppRoot) / sizeof(TCHAR));
        ::StringCbCopy(::_tcsrchr(szAppRoot, _T('\\')) + 1,
            sizeof(szAppRoot), _T("*.*"));

        // チェックリストビューにアイテム追加
        CFindFile find;
        if(find.FindFile(szAppRoot)){
            do{
                if(!find.IsDots()){
                    int nIndex = m_list_dir.GetItemCount();
                    m_list_dir.AddItem(nIndex, 0, find.GetFileName());
                }
            }while(find.FindNextFile());
        }

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

        SetMsgHandled(false);

        return TRUE;
    }

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

    void OnButtonCount(UINT uNotifyCode, int nID, CWindow wndCtl){
        int nCheckedCount = 0;
        int nCount = m_list_dir.GetItemCount();
        for(int i=0; i<nCount; i++){
            if(m_list_dir.GetCheckState(i))
                nCheckedCount++;
        }
        CString strMsg;
        strMsg.Format(_T("チェックされたアイテム数：%d"), nCheckedCount);
        MessageBox(strMsg);
    }
};

// SampleProject.cpp
#include "stdafx.h"
#include "resourceppc.h"
#include "SampleProjectDialog.h"

CAppModule _Module;

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

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

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

    AtlInitCommonControls(ICC_LISTVIEW_CLASSES);
    SHInitExtraControls();

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

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

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

    return nRet;
}

　まず、リソースを作成します。ダイアログにリストビューコントロールとボタンコントロールを配置し、それぞれの［ID］と［Caption］を次のように設定します。なお、リストビューコントロールの［プロパティ］では［View］を［レポート］に設定し、［Always Show Selection］を［True］に設定します。

コントロール名	ID	Caption
リストビュー	IDC_LIST_DIR	-
ボタン	IDC_BUTTON_COUNT	チェックされたアイテム数を取得

　次に、stdafx.hヘッダでは、CCheckListViewCtrlクラスを使用するためにatlctrls.hヘッダとatlctrlx.hヘッダをインクルードします。なお、atlctrls.hヘッダを先にインクルードする必要があります。

　CSampleProjectDialogクラスでは、まず、 CCheckListViewCtrlクラスのインスタンスをメンバ変数として宣言します。これを使うためには、WM_INITDIALOGメッセージハンドラでサブクラス化する必要があります。

　次に、WM_INITDIALOGメッセージハンドラでは、チェックリストビューコントロールにアプリケーションと同じフォルダにあるフォルダ名とファイル名をアイテムとして追加します。

　次に、リソースIDがIDC_BUTTON_COUNTのWM_COMMANDメッセージハンドラとして、 OnButtonCount()を追加します。このハンドラ関数では、チェックリストビューコントロールの中でチェックされているアイテム数をカウントし、それをメッセージボックスで表示します。

　最後に_tWinMain()で、引数にICC_LISTVIEW_CLASSESを指定してAtlInitCommonControls()を呼び出します。

　ところで、今回の例ではチェックリストビューコントロールを作成するために、ダイアログ上にコントロールリソースを配置してサブクラス化しましたが、 Create()を呼び出して作成することもできます。

m_list_dir.Create(m_hWnd, CRect(0, 0, 200, 100), NULL, 0, 0, IDC_LIST_DIR);

この時、Create()の第4引数にはウィンドウスタイル、第5引数には拡張ウィンドウスタイルを指定しますが、これらの引数に 0 を指定した場合は、デフォルトのウィンドウ特徴としてCCheckListViewCtrlTraitsクラスが使用されます。 CCheckListViewCtrlTraitsクラスはatlctrlx.hヘッダで次のように宣言されています。

template <DWORD t_dwStyle, DWORD t_dwExStyle, DWORD t_dwExListViewStyle>
class CCheckListViewCtrlImplTraits
{
public:
    static DWORD GetWndStyle(DWORD dwStyle)
    {
        return (dwStyle == 0) ? t_dwStyle : dwStyle;
    }

    static DWORD GetWndExStyle(DWORD dwExStyle)
    {
        return (dwExStyle == 0) ? t_dwExStyle : dwExStyle;
    }

    static DWORD GetExtendedLVStyle()
    {
        return t_dwExListViewStyle;
    }
};

typedef CCheckListViewCtrlImplTraits<WS_CHILD | WS_VISIBLE |
    LVS_REPORT | LVS_SHOWSELALWAYS, WS_EX_CLIENTEDGE,
    LVS_EX_CHECKBOXES | LVS_EX_FULLROWSELECT>  CCheckListViewCtrlTraits;

CCheckListViewCtrlImplTraitsクラステンプレートはATLのCWinTraitsクラステンプレートと違い、ウィンドウスタイル、拡張ウィンドウスタイルに加えて拡張リストビュースタイルも設定します。

CCheckListViewCtrlクラスは次のように定義されています。

// atlctrlx.h
template <class T, class TBase = CListViewCtrl,
    class TWinTraits = CCheckListViewCtrlTraits>
class ATL_NO_VTABLE CCheckListViewCtrlImpl : 
    public ATL::CWindowImpl<T, TBase, TWinTraits>
{
    ...
    ...
};

class CCheckListViewCtrl : public CCheckListViewCtrlImpl<CCheckListViewCtrl>
{
public:
    DECLARE_WND_SUPERCLASS(_T("WTL_CheckListView"), GetWndClassName())
};

このため、カスタマイズしたウィンドウ特徴クラスをCCheckListViewCtrlImplクラステンプレートの第3テンプレート引数に指定することで、独自のスタイルのチェックリストビューコントロールを作成することができます。次に示すのは、拡張リストビュースタイルとしてLVS_EX_GRIDLINESスタイルを持った独自のチェックリストビュークラスを定義する例です。

typedef CCheckListViewCtrlImplTraits<WS_CHILD | WS_VISIBLE |
    LVS_REPORT | LVS_SHOWSELALWAYS, WS_EX_CLIENTEDGE,
    LVS_EX_CHECKBOXES | LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES>  CMyTraits;

class CMyCheckListViewCtrl : 
    public CCheckListViewCtrlImpl<CMyCheckListViewCtrl, CListViewCtrl, CMyTraits>
{
public:
    DECLARE_WND_SUPERCLASS(_T("MyCheckListView"), GetWndClassName())
};

なお、LVS_EX_GRIDLINESのような拡張リストビュースタイルを変更するならば、 SetExtendedListViewStyle()を使用することもできます。その場合、チェックリストビューコントロールで必須のLVS_EX_CHECKBOXES スタイルも同時に指定します。

CCheckListViewCtrl m_list_dir;
...
...
m_list_dir.SetExtendedListViewStyle(
    LVS_EX_CHECKBOXES | LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES);