ホーム ATL/WTL
バルーンツールチップ
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2004/02/07
PR
 Internet Explorer 5 以降がインストールされているシステムでは、 バルーンツールチップを使用できます。 バルーンツールチップとは、ふきだしのような形をしたツールチップです。 WTLのCToolTipCtrlクラスは、バルーンツールチップのためのメンバ関数を用意しています。

以下に示すのは、CToolTipCtrlクラスを使ってバルーンツールチップを表示する例です。 ダイアログ上のボタンコントロールにマウスカーソルを乗せると、 「バルーンツールチップのサンプル」というツールチップを表示します。


// stdafx.h内
#define _WIN32_IE  0x0500

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

    // メッセージマップ
    BEGIN_MSG_MAP_EX(CMainDlg)
        MSG_WM_INITDIALOG(OnInitDialog)
        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);

        // ツールチップコントロール作成
        CToolTipCtrl tooltip;
        tooltip.Create(m_hWnd, NULL, NULL, TTS_BALLOON);
        tooltip.Activate(TRUE);

        tooltip.SetTitle(1, _T("バルーンツールチップ"));

        // ボタンコントロールのツールチップ情報をツールチップコントロールに追加
        CToolInfo tiBtn(TTF_SUBCLASS,
            GetDlgItem(IDOK), 0, NULL, _T("バルーンツールチップのサンプル"));
        tooltip.AddTool(tiBtn);

        return TRUE;
    }

    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
プッシュボタン IDOK

 次に、stdafx.h内で_WIN32_IE0x0500に定義します。 これにより、CToolTipCtrl::SetTitle()が使用可能になります。 さらに、CToolTipCtrlクラスを使用するためにatlctrls.hヘッダをインクルードします。

 CMainDlgクラスのWM_INITDIALOGメッセージハンドラでは、 ツールチップコントロールを作成するときにCreate()の第4引数にTTS_BALLOONを指定し、 SetTitle()でバルーンツールチップにアイコンとタイトルを設定しています。