ホーム ATL/WTL
ハイパーリンク
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2007/03/25
PR
 ハイパーリンクコントロールは、Webページのハイパーリンクのようなコントロールです。 コモンコントロールのSysLinkコントロールと同じような機能を備えていますが、 ハイパーリンクコントロールは Windows XP 以外でも使用できます。 WTLはハイパーリンクコントロールを作成するためにCHyperLinkというクラスを用意しています。

以下に示すのは、CHyperLinkクラスを使用する例です。


プロジェクトファイル ダウンロード
// 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>
#include <atlctrlx.h>  // CHyperLinkを使用するため
			

// MainDlg.h
#pragma once

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

    CHyperLink m_link_google;     // ハイパーリンク

    BEGIN_MSG_MAP(CMainDlg)
        MSG_WM_INITDIALOG(OnInitDialog)
        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_google.SubclassWindow(GetDlgItem(IDC_STATIC_LINK));
        m_link_google.SetLabel(_T("WTL"));
        m_link_google.SetHyperLink(_T("http://wtl.sourceforge.net/"));

        return TRUE;
    }

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

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

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

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

    return nRet;
}
			

 まず、リソースを作成します。ダイアログにスタティックコントロールを配置し、 [Caption]と[ID]を次のように設定します。

コントロール名 Caption ID
スタティック スタティック IDC_STATIC_LINK

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

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

 次に、WM_INITDIALOGメッセージハンドラで CHyperLinkクラスのメンバ関数であるSetLabel()SetHyperLink()を呼び出して、 ハイパーリンクコントロールにラベルとリンクを設定します。

 このように、ハイパーリンクコントロールを作成するためには、 スタティックコントロールをサブクラス化します。 なお、Create()を呼び出して作成することもできます。

 WTLのハイパーリンクコントロールは、独自の拡張スタイルを用意しています。

  • HLINK_UNDERLINED
    下線を表示します。このスタイルはデフォルトで設定されています。

  • HLINK_NOTUNDERLINED
    下線を表示しません。

  • HLINK_UNDERLINEHOVER
    マウスカーソルがハイパーリンクの上を通る時に、下線を表示します。

  • HLINK_COMMANDBUTTON
    クリックした時(Navigate()が呼び出された時)に親ウィンドウにWM_COMMANDメッセージを送ります。自動的にブラウザを起動しません。

  • HLINK_NOTIFYBUTTON
    クリックした時(Navigate()が呼び出された時)に親ウィンドウにWM_NOTIFYメッセージを送ります。自動的にブラウザを起動しません。

  • HLINK_USETAGS
    ラベル内の<A>タグに囲まれた文字列をリンク化します。リンク文字列は自動的に左寄せされます。

  • HLINK_USETAGSBOLD
    ラベル内の<A>タグに囲まれた文字列を太字でリンク化します。リンク文字列は自動的に左寄せされます。このスタイルを使用すると、HLINK_UNDERLINEDスタイルは無視されます。

  • HLINK_NOTOOLTIP
    ツールチップを表示しません。

これらの拡張スタイルをハイパーリンクコントロールに設定するためには、 ハイパーリンクコントロールをサブクラス化する前に SetHyperLinkExtendedStyle()を呼び出す必要があります。 次に示すのは、HLINK_USETAGSスタイルを追加して、ラベル内で<A>タグを使用する例です。


プロジェクトファイル ダウンロード
BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){
    ...
    ...
    
    // コントロール設定
    m_link_google.SetHyperLinkExtendedStyle(HLINK_USETAGS);  // 拡張スタイル設定
    m_link_google.SubclassWindow(GetDlgItem(IDC_STATIC_LINK));
    m_link_google.SetLabel(_T("<a>WTL</a>へジャンプ"));
    m_link_google.SetHyperLink(_T("http://wtl.sourceforge.net/"));

    return TRUE;
}