ホーム ATL/WTL
リストビュー
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2007/03/21
PR
 WTLではコモンコントロールのリストビューコントロールをCListViewCtrlT というクラステンプレートでカプセル化しています。 テンプレート引数にはクラスを指定しますが、 そのクラスはCListViewCtrlTの基底クラスとして使用されます。 atlctrls.hヘッダではtypedefによって次のように宣言されています。

// atlctrls.h
typedef CListViewCtrlT<ATL::CWindow>   CListViewCtrl;
			

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

 WTLのCListViewCtrlクラスは、MFCのCListCtrlクラスと同等の機能を備えているほか、 拡張機能も備えています。 以下に示すのは、CListViewCtrlクラスを使用する例です。 カレントディレクトリのフォルダ名とファイル名をリストビューに追加し、 アイテムをダブルクリックすると名前と種類をメッセージボックスで表示します。


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

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

#include <atlcrack.h>
#include <atlmisc.h>
#include <atlctrls.h>  // コントロール用クラスを使用するため
			

// MainDlg.h
#pragma once

class CMainDlg : public CDialogImpl<CMainDlg>
{
public:
    enum { IDD = IDD_MAINDLG };

    CListViewCtrl m_list_file;

    BEGIN_MSG_MAP(CMainDlg)
        MSG_WM_INITDIALOG(OnInitDialog)
        NOTIFY_HANDLER_EX(IDC_LIST_FILE, NM_DBLCLK, OnListDblClick)
        COMMAND_ID_HANDLER_EX(IDOK, OnOK)
        COMMAND_ID_HANDLER_EX(IDCANCEL, OnCancel)
    END_MSG_MAP()

    BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){
        // スクリーンの中央に配置
        CenterWindow();

        // 大きいアイコン設定
        HICON hIcon = AtlLoadIconImage(IDR_MAINFRAME, LR_DEFAULTCOLOR,
            ::GetSystemMetrics(SM_CXICON), ::GetSystemMetrics(SM_CYICON));
        SetIcon(hIcon, TRUE);
        
        // 小さいアイコン設定
        HICON hIconSmall = AtlLoadIconImage(IDR_MAINFRAME, LR_DEFAULTCOLOR,
            ::GetSystemMetrics(SM_CXSMICON), ::GetSystemMetrics(SM_CYSMICON));
        SetIcon(hIconSmall, FALSE);

        // コントロール設定
        m_list_file = GetDlgItem(IDC_LIST_FILE);

        m_list_file.SetExtendedListViewStyle(LVS_EX_INFOTIP | LVS_EX_FULLROWSELECT);

        // リストビューコントロールにカラム挿入
        CRect rcList;
        m_list_file.GetWindowRect(rcList);
        int nScrollWidth = GetSystemMetrics(SM_CXVSCROLL);
        int n3DEdge = GetSystemMetrics(SM_CXEDGE);
        m_list_file.InsertColumn(0, _T("名前"), LVCFMT_LEFT, 190, -1);
        m_list_file.InsertColumn(1, _T("種類"), LVCFMT_LEFT,
            rcList.Width() - 190 - nScrollWidth - n3DEdge * 2, -1);

        // リストビューコントロールにアイテム追加
        CFindFile find;
        if(find.FindFile()){
            do{
                if(!find.IsDots()){
                    int nIndex = m_list_file.GetItemCount();
                    m_list_file.AddItem(nIndex, 0, find.GetFileName());
                    m_list_file.AddItem(nIndex, 1,
                        find.IsDirectory() ? _T("フォルダ") : _T("ファイル"));
                }
            }while(find.FindNextFile());
        }

        return TRUE;
    }

    LRESULT OnListDblClick(LPNMHDR pnmh){
        LPNMITEMACTIVATE pnmia = (LPNMITEMACTIVATE)pnmh;

        CString strItem;
        m_list_file.GetItemText(pnmia->iItem, 0, strItem);

        CString strSubItem;
        m_list_file.GetItemText(pnmia->iItem, 1, strSubItem);

        MessageBox(strItem + _T("は") + strSubItem + _T("です。"), _T("アイテム"));

        return 0;
    }

    void OnOK(UINT uNotifyCode, int nID, CWindow wndCtl){
        EndDialog(nID);
    }

    void OnCancel(UINT uNotifyCode, int nID, CWindow wndCtl){
        EndDialog(nID);
    }
};
			

// SampleProject.cpp
#include "stdafx.h"
#include "resource.h"
#include "MainDlg.h"

CAppModule _Module;

int WINAPI _tWinMain(HINSTANCE hInstance, 
    HINSTANCE /*hPrevInstance*/, LPTSTR /*lpstrCmdLine*/, int /*nCmdShow*/)
{
    HRESULT hRes = ::CoInitialize(NULL);
    ATLASSERT(SUCCEEDED(hRes));

    ::DefWindowProc(NULL, 0, 0, 0L);

    AtlInitCommonControls(ICC_WIN95_CLASSES);

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

    CMainDlg dlg;
    int nRet = (int) dlg.DoModal();

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

    return nRet;
}
			

 まず、リソースを作成します。ダイアログにリストビューコントロールを配置し、 [ID]を次のように設定します。 なお、リストビューコントロールの[プロパティ]では[View]を[レポート]に設定し、 [Single Selection]を[True]に設定します。

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

 次に、stdafx.hヘッダでは、CListViewCtrlクラスを使用するためにatlctrls.hヘッダをインクルードします。

 CMainDlgクラスでは、まず、リストビューコントロール用にCListViewCtrlクラスのインスタンスをメンバ変数として宣言します。 これを使うためには、WM_INITDIALOGメッセージハンドラでコントロールのハンドルを代入する必要があります。

 次に、WM_INITDIALOGメッセージハンドラでリストビューコントロールの拡張スタイルを設定し、 カラムを2列挿入します。さらに、CFindFileクラスを使用してカレントディレクトリのフォルダとファイルを走査し、リストビューコントロールにフォルダ名とファイル名を追加します。 なお、CFindFileクラスはatlmisc.hヘッダに定義されており、 名前が似ているMFCのCFileFindクラスとほぼ同じメンバ関数を用意しています。

 次に、通知コードがNM_DBLCLKのリストビューコントロール用WM_NOTIFYメッセージハンドラとしてOnListDblClick()を追加します。 このハンドラ関数ではダブルクリックされたアイテムのテキストを取得し、 メッセージボックスで表示します。

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