チェックリストビューは、チェックボックス付きのリストビューコントロールです。
WTLはチェックリストビューを作成するためにCCheckListViewCtrlというクラスを用意しています。
CCheckListViewCtrlクラスはCListViewCtrlクラスから派生しており、
デフォルトでLVS_EX_CHECKBOXESスタイルが設定されています。
以下に示すのは、CCheckListViewCtrlクラスを使用する例です。
// stdafx.h内
#include <atlbase.h>
#include <atlapp.h>
extern CAppModule _Module;
#include <atlwin.h>
#include <atlcrack.h>
#include <atlmisc.h>
#include <atlctrls.h>
#include <atlctrlx.h> // CCheckListViewCtrlクラスを使用するため
|
// maindlg.h内
class CMainDlg : public CDialogImpl<CMainDlg>
{
public:
enum { IDD = IDD_MAINDLG };
CCheckListViewCtrl m_list_dir; // チェックリストビュー
// メッセージマップ
BEGIN_MSG_MAP_EX(CMainDlg)
MSG_WM_INITDIALOG(OnInitDialog)
COMMAND_ID_HANDLER_EX(IDC_BUTTON_COUNT, OnButtonCount)
COMMAND_ID_HANDLER_EX(IDOK, OnOK)
COMMAND_ID_HANDLER_EX(IDCANCEL, OnCancel)
END_MSG_MAP()
LRESULT OnInitDialog(HWND hWnd, LPARAM lParam){
// スクリーンの中央に配置
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_dir.SubclassWindow(GetDlgItem(IDC_LIST_DIR));
// チェックリストビューにカラム設定
CRect rcList;
m_list_dir.GetWindowRect(rcList);
int nScrollWidth = GetSystemMetrics(SM_CXVSCROLL);
int n3DEdge = GetSystemMetrics(SM_CXEDGE);
m_list_dir.InsertColumn(0, _T("名前"), LVCFMT_LEFT,
rcList.Width() - nScrollWidth - n3DEdge * 2, -1);
// チェックリストビューにアイテム追加
CFindFile find;
if(find.FindFile()){
do{
if(!find.IsDots()){
int nIndex = m_list_dir.GetItemCount();
m_list_dir.AddItem(nIndex, 0, find.GetFileName());
}
}while(find.FindNextFile());
}
return TRUE;
}
void OnButtonCount(UINT uNotifyCode, int nID, HWND hWndCtl){
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);
}
void OnOK(UINT uNotifyCode, int nID, HWND hWndCtl){
EndDialog(nID);
}
void OnCancel(UINT uNotifyCode, int nID, HWND hWndCtl){
EndDialog(nID);
}
};
|
// Control.cpp内
#include "stdafx.h"
#include "resource.h"
#include "maindlg.h"
CAppModule _Module;
int WINAPI _tWinMain(HINSTANCE hInstance, HINSTANCE, LPTSTR lpCmdLine, int nCmdShow)
{
HRESULT hRes = ::CoInitialize(NULL);
ATLASSERT(SUCCEEDED(hRes));
::DefWindowProc(NULL, 0, 0, 0L);
AtlInitCommonControls(ICC_COOL_CLASSES | ICC_WIN95_CLASSES);
hRes = _Module.Init(NULL, hInstance);
ATLASSERT(SUCCEEDED(hRes));
int nRet = 0;
// BLOCK: アプリケーション実行
{
CMainDlg dlgMain;
nRet = dlgMain.DoModal();
}
_Module.Term();
::CoUninitialize();
return nRet;
}
|
まず、リソースを作成します。ダイアログにリストビューコントロールとボタンコントロールを配置し、
リソースIDを次のように指定します。
なお、リストビューコントロールの[スタイル]ではデフォルトに加え[表示]で[レポート]を選択し、
[選択を常に表示]にチェックを入れます。
| コントロール名 |
リソースID |
| リストビュー |
IDC_LIST_DIR |
| プッシュボタン |
IDC_BUTTON_COUNT |
CMainDlgクラスでは、まず、
CCheckListViewCtrlクラスのインスタンスをメンバ変数として宣言します。
これを使うためには、WM_INITDIALOGメッセージハンドラでサブクラス化する必要があります。
次に、WM_INITDIALOGメッセージハンドラでは、
チェックリストビューにカレントディレクトリ内のフォルダとファイルをアイテムとして追加します。
最後に、リソースIDがIDC_BUTTON_COUNTのコマンドメッセージハンドラとして、
OnButtonCount()を追加します。
このハンドラでは、チェックリストビューの中でチェックされているアイテムをカウントし、
それをメッセージボックスを表示しています。
ところで、上の例ではチェックリストビューを作成するために、
ダイアログ上にコントロールリソースを配置してサブクラス化しましたが、
Create()を使って作成することもできます。
m_list_dir.Create(m_hWnd, CRect(0, 0, 200, 100), NULL, 0, 0, IDC_LIST_DIR);
|
サブクラス化によって作成した場合はリソースのプロパティによってスタイル（[レポート]や[選択を常に表示]）を設定しましたが、
Create()を使って作成した場合は、スタイルを第４引数（ウィンドウスタイル）、
第５引数（拡張ウィンドウスタイル）によって設定します。
これらの引数に 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内
// CCheckListViewCtrlクラスの基底クラス
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())
};
|
このため、カスタマイズしたCCheckListViewCtrlImplTraitsクラス
をCCheckListViewCtrlImplクラスの第３テンプレート引数に指定すれば、
独自のスタイルのチェックリストビューコントロールを作成することができます。
次に示すのは、拡張リストビュースタイルとしてLVS_EX_INFOTIPスタイルを持った
独自のチェックリストビューコントロールクラスを定義する例です。
typedef CCheckListViewCtrlImplTraits<WS_CHILD | WS_VISIBLE |
LVS_REPORT | LVS_SHOWSELALWAYS, WS_EX_CLIENTEDGE,
LVS_EX_CHECKBOXES | LVS_EX_FULLROWSELECT | LVS_EX_INFOTIP> CMyTraits;
class CMyCheckListViewCtrl :
public CCheckListViewCtrlImpl<CMyCheckListViewCtrl, CListViewCtrl, CMyTraits>
{
public:
DECLARE_WND_SUPERCLASS(_T("MyCheckListView"), GetWndClassName())
};
|
なお、LVS_EX_INFOTIPのような拡張リストビュースタイルを変更するならば、
SetExtendedListViewStyle()を使用することもできます。
このとき、チェックリストビューコントロールで必須のLVS_EX_CHECKBOXES
スタイルも同時に指定します。
CCheckListViewCtrl m_list;
...
...
m_list.SetExtendedListViewStyle(
LVS_EX_CHECKBOXES | LVS_EX_FULLROWSELECT | LVS_EX_INFOTIP);
|
|
