ソートリストビュー

ホーム

WTL Mobile

ソートリストビュー

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

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

CSortListViewCtrlクラスはCListViewCtrlクラスから派生しています。以下に示すのは、CSortListViewCtrlクラスを使用する例です。

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

// 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>  // CSortListViewCtrlを使用するため

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

    CSortListViewCtrl 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)
        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, 130, -1);
        m_list_dir.InsertColumn(1, _T("サイズ"), LVCFMT_RIGHT,
            rcList.Width() - 130 - nScrollWidth - nBorder * 2, -1);

        // ソートタイプ設定
        m_list_dir.SetColumnSortType(0, LVCOLSORT_TEXT);
        m_list_dir.SetColumnSortType(1, LVCOLSORT_LONG);
        
        // アプリケーションがあるフォルダパスを取得
        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());
                    CString strLength;
                    strLength.Format(_T("%ld"), find.GetFileSize());
                    m_list_dir.AddItem(nIndex, 1, strLength);
                }
            }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);
    }
};

// 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］を次のように設定します。なお、リストビューコントロールの［プロパティ］では［View］を［レポート］に設定し、［Always Show Selection］を［True］に設定します。

コントロール名	ID
リストビュー	IDC_LIST_DIR

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

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

　次に、WM_INITDIALOGメッセージハンドラでソートリストビューコントロールにカラムを追加し、それぞれのカラムにソートタイプを設定します。ソートリストビューコントロールでは以下のソートタイプを設定することができます。

ソートタイプ	意味
LVCOLSORT_NONE	ソートしない
LVCOLSORT_TEXT	テキスト値としてソート（デフォルト）
LVCOLSORT_TEXTNOCASE	大文字と小文字を区別しないテキスト値としてソート
LVCOLSORT_LONG	long値としてソート
LVCOLSORT_DOUBLE	double値としてソート
LVCOLSORT_DECIMAL	小数値としてソート
LVCOLSORT_DATETIME	日時としてソート
LVCOLSORT_DATE	日付としてソート
LVCOLSORT_TIME	時間としてソート
LVCOLSORT_CUSTOM	独自のデータとしてソート

ソートタイプにLVCOLSORT_CUSTOMを設定した場合は、 CompareItemsCustom()をオーバーライドして独自のソート処理を記述します。

次に、ソートリストビューコントロールにアプリケーションと同じフォルダにあるフォルダ名とファイル名をアイテムとして追加します。

　最後に_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 を指定した場合は、デフォルトのウィンドウ特徴としてCSortListViewCtrlTraitsクラスが使用されます。 CSortListViewCtrlTraitsクラスはatlctrlx.hヘッダで次のように宣言されています。

typedef ATL::CWinTraits<WS_CHILD | WS_VISIBLE | WS_CLIPCHILDREN | WS_CLIPSIBLINGS | 
    LVS_REPORT | LVS_SHOWSELALWAYS , WS_EX_CLIENTEDGE>   CSortListViewCtrlTraits;

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

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

class CSortListViewCtrl : public CSortListViewCtrlImpl<CSortListViewCtrl>
{
public:
    DECLARE_WND_SUPERCLASS(_T("WTL_SortListViewCtrl"), GetWndClassName())
};

CSortListViewCtrlImplクラステンプレートの第3テンプレート引数に独自のウィンドウ特徴を指定することで、ソートリストビューコントロールのウィンドウスタイルを変更することができます。