ホーム ATL/WTL
拡張ツリービュー
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2004/02/07
PR
 WTLではコモンコントロールのツリービューコントロールをカプセル化するためにCTreeViewCtrlTクラスを用意していますが、 CTreeViewCtrlExTというクラスも用意しています。 このクラスはCTreeViewCtrlTクラスと同様にテンプレートクラスです。 CTreeViewCtrlExTクラスはCTreeViewCtrlTクラスの派生クラスであり、 CTreeViewCtrlExTクラスのテンプレート引数は基底クラスである CTreeViewCtrlTクラスへ渡されます。 atlctrls.hヘッダでは次のように宣言されています。

// atlctrls.h内
template <class TBase>
class CTreeViewCtrlExT : public CTreeViewCtrlT< TBase >
{
...
...

typedef CTreeViewCtrlExT<ATL::CWindow>   CTreeViewCtrlEx;
			

CTreeViewCtrlExTクラスはCTreeItemTというテンプレートクラスを使用します。 CTreeItemTクラスはツリーアイテムハンドルHTREEITEMをカプセル化します。 また、CTreeItemTクラスはCTreeViewCtrlExTクラスへのポインタをメンバ変数として持ちます。 CTreeItemTクラスのテンプレート引数は、 このメンバ変数であるCTreeViewCtrlExTクラスへ渡されます。 atlctrls.hヘッダでは次のように宣言されています。

// atlctrls.h内
template <class TBase>
class CTreeItemT
{
public:
    HTREEITEM m_hTreeItem;
    CTreeViewCtrlExT<TBase>* m_pTreeView;
...
...

typedef CTreeItemT<ATL::CWindow>   CTreeItem;
			

 CTreeViewCtrlExクラスはCTreeViewCtrlクラスと同等の機能を備えています。 以下に示すのは、CTreeViewCtrlExクラスを使用する例です。 前回ツリービューコントロールを使用したプログラムのCTreeViewCtrlを、 CTreeViewCtrlExに変更して書き換えます。


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

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

// maindlg.h内
class CMainDlg : public CDialogImpl<CMainDlg>
{
public:
    enum { IDD = IDD_MAINDLG };

    enum {SHELL = 1, COMCTL, WINDIR, SYSDIR}; // ツリーアイテム識別子
    
    CTreeViewCtrlEx m_tree_sysinfo;  // 拡張ツリービュー
    CStatic m_static_display;        // 情報表示用

    // メッセージマップ
    BEGIN_MSG_MAP_EX(CMainDlg)
        MSG_WM_INITDIALOG(OnInitDialog)
        NOTIFY_HANDLER_EX(IDC_TREE_SYSINFO, NM_CLICK, OnTreeClick)
        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_tree_sysinfo = GetDlgItem(IDC_TREE_SYSINFO);
        m_static_display = GetDlgItem(IDC_STATIC_DISPLAY);

        CTreeItem tiSysInfo =
            m_tree_sysinfo.InsertItem(_T("システム情報"), TVI_ROOT, TVI_LAST);

        CTreeItem tiDllVer = tiSysInfo.AddTail(_T("DLLバージョン"), -1);

        CTreeItem tiItem;

        tiItem = tiDllVer.AddTail(_T("shell32.dll"), -1);
        tiItem.SetData(SHELL);
        tiItem = tiDllVer.AddTail(_T("comctl32.dll"), -1);
        tiItem.SetData(COMCTL);

        CTreeItem tiSysDir = tiSysInfo.AddTail(_T("ディレクトリ"), -1);

        tiItem = tiSysDir.AddTail(_T("Windows"), -1);
        tiItem.SetData(WINDIR);
        tiItem = tiSysDir.AddTail(_T("システム"), -1);
        tiItem.SetData(SYSDIR);

        return TRUE;
    }

    LRESULT OnTreeClick(LPNMHDR pnmh){
        // クリックされたアイテムハンドル取得
        UINT uFlag;
        CPoint pt = ::GetMessagePos();
        m_tree_sysinfo.ScreenToClient(&pt);
        CTreeItem tiItem = m_tree_sysinfo.HitTest(pt, &uFlag);
        if(tiItem.IsNull() || !(uFlag & TVHT_ONITEM))
            return 0;

        // アイテムデータ取得
        CString strInfo;
        DWORD dwData = tiItem.GetData();
        switch(dwData){
        case SHELL:
        {
            // shell32.dllのバージョン取得
            DWORD dwMajor, dwMinor;
            AtlGetShellVersion(&dwMajor, &dwMinor);
            strInfo.Format(_T("Version %d.%02d"), dwMajor, dwMinor);
            break;
        }
        case COMCTL:
        {
            // comctl32.dllのバージョン取得
            DWORD dwMajor, dwMinor;
            AtlGetCommCtrlVersion(&dwMajor, &dwMinor);
            strInfo.Format(_T("Version %d.%02d"), dwMajor, dwMinor);
            break;
        }
        case WINDIR:
        {
            // Windowsフォルダパス取得
            TCHAR szPath[MAX_PATH];
            GetWindowsDirectory(szPath, MAX_PATH);
            strInfo = szPath;
            break;
        }
        case SYSDIR:
        {
            // システムフォルダパス取得
            TCHAR szPath[MAX_PATH];
            GetSystemDirectory(szPath, MAX_PATH);
            strInfo = szPath;
            break;
        }
        default:
            break;
        }
        m_static_display.SetWindowText(strInfo);

        return 0;
    }

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

 まず、CMainDlgクラスのCTreeViewCtrlCTreeViewCtrlExに置き換えます。

 次に、WM_INITDIALOGメッセージハンドラでツリービューコントロールにアイテムを挿入しますが、 前回はInsertItem()の返り値はツリーアイテムハンドルであったのに対し、 今回はCTreeViewCtrlExクラスを使用しているので返り値はCTreeItemクラスのインスタンスです。 このインスタンスの中には、すでにツリーアイテムハンドルとm_tree_sysinfoへのポインタが設定されています。 挿入したアイテムの下にさらに子アイテムを追加するには、CTreeItemのインスタンスのAddTail()を呼び出します。

 OnTreeClick()では、HitTest()の返り値から CTreeItemクラスのインスタンスを取得した後、 IsNull()によってツリーアイテムハンドルか有効かどうかを判断し、 有効な場合はGetData()によってそのアイテムからデータを取得しています。

このように、CTreeViewCtrlExクラスを使うと、 特定のツリーアイテムを起点としてツリービューコントロールを操作できます。