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

// atlctrls.h
typedef CLinkCtrlT<ATL::CWindow>   CLinkCtrl;
			

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

 WTLのCLinkCtrlクラスは、MFCの同名のクラスと同等の機能を備えています。 以下に示すのは、CLinkCtrlクラスを使用する例です。 ダイアログ上のリンクをクリックすると、Webブラウザを開いてそのリンク先のページを表示します。


プロジェクトファイル ダウンロード
// 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 };

    CLinkCtrl m_link_url;

    BEGIN_MSG_MAP(CMainDlg)
        MSG_WM_INITDIALOG(OnInitDialog)
        NOTIFY_HANDLER_EX(IDC_LINK_URL, NM_CLICK, OnLinkClick)
        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_link_url = GetDlgItem(IDC_LINK_URL);

        LITEM item;
        item.mask = LIF_ITEMINDEX | LIF_URL;
        item.iLink = 0;
        lstrcpyW(item.szUrl, L"http://wtl.sourceforge.net/");
        m_link_url.SetItem(&item);

        return TRUE;
    }

    LRESULT OnLinkClick(LPNMHDR pnmh){
        PNMLINK pNMLink = (PNMLINK)pnmh;

        ShellExecuteW(m_hWnd, L"open", pNMLink->item.szUrl, NULL, NULL, SW_SHOWNORMAL);

        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_LINK_CLASS);

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

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

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

    return nRet;
}
			

 まず、リソースを作成します。 SysLinkコントロールを作成するためには、ダイアログにカスタムコントロールを配置し、 [プロパティ]で[Class]を[SysLink]に設定します。[Caption]と[ID]は次のように設定します。

コントロール名 Caption ID
SysLink WTLの入手先は<a>こちら</a>です IDC_LINK_URL

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

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

 次に、WM_INITDIALOGメッセージハンドラで CLinkCtrlクラスのメンバ関数であるSetItem()を呼び出して、 SysLinkコントロールのリンク部分にURLを設定します。

 次に、通知コードがNM_CLICKのSysLinkコントロール用WM_NOTIFYメッセージハンドラとしてOnLinkClick()を追加します。 このハンドラ関数ではクリックされたリンクのURLをWebブラウザで開きますが、 URLはUnicode文字列として保持されているので、ShellExecuteW()を使用します。

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

 ところで、今回の例ではWM_INITDIALOGメッセージハンドラでSetItem()を呼び出して動的にURLを設定しましたが、 次に示すようにリソースで静的にURLを設定することも可能です。

コントロール名 キャプション リソースID
SysLink WTLの入手先は<a href="http://wtl.sourceforge.net/">こちら</a>です IDC_LINK_URL

静的に設定した場合はSetItem()を呼び出す必要はありません。