CWnd::OnToolHitTest
更新 : 2007 年 11 月
指定したツールに外接する四角形内にマウス ポインタがあるかどうかを判断するために、フレームワークからこのメンバ関数が呼び出されます。
virtual INT_PTR OnToolHitTest(
CPoint point,
TOOLINFO* pTI
) const;
パラメータ
point
カーソルの x 座標と y 座標を指定します。座標は、常にウィンドウの左上隅からの相対位置になります。pTI
TOOLINFO 構造体へのポインタ。既定では、次の構造体の値が設定されます。hwnd = m_hWnd ウィンドウへのハンドル。
uId = (UINT)hWndChild 子ウィンドウへのハンドル。
uFlags |= TTF_IDISHWND ツールのハンドル。
lpszText = LPSTR_TEXTCALLBACK 指定されたウィンドウに表示される文字列へのポインタ。
戻り値
ツール ヒント コントロールが見つかった場合は、ウィンドウ コントロール ID を返します。ツール ヒント コントロールが見つからなかった場合は、-1 を返します。
解説
マウス ポインタが四角形の中にある場合は、ツールに関する情報を取得できます。
ツール ヒントが関連付けられている領域がボタンでない場合、OnToolHitTest は構造フラグを TTF_NOTBUTTON と TTF_CENTERTIP に設定します。
既定で提供される情報とは異なる情報を提供するには、OnToolHitTest をオーバーライドします。
構造体の詳細については、Windows SDK の「TOOLINFO」を参照してください。
必要条件
ヘッダー : afxwin.h