点をテストして、指定されたツールに外接する四角形内部にあるかどうかを調べます。四角形の内部にあれば、そのツールの情報を取得します。
BOOL HitTest(
CWnd* pWnd,
CPoint pt,
LPTOOLINFO lpToolInfo
) const;
パラメーター
pWnd
ツールを保持するウィンドウへのポインター。pt
テストされる点の座標を持つ CPoint オブジェクトへのポインター。lpToolInfo
ツールについての情報を保持する TOOLINFO 構造体へのポインター。
戻り値
ヒット テスト情報が指定する点がツールに外接する四角形内部にある場合は 0 以外を返します。それ以外の場合は 0 を返します。
解説
この関数が 0 以外の値を返すときは、その点を含む四角形内のツールの情報が lpToolInfo が指す構造体に設定されます。
TTHITTESTINFO 構造体は次のように定義されています。
typedef struct _TT_HITTESTINFO { // tthti
HWND hwnd; // handle of tool or window with tool
POINT pt; // client coordinates of point to test
TOOLINFO ti; // receives information about the tool
} TTHITTESTINFO, FAR * LPHITTESTINFO;
hwnd
ツールのハンドルを示します。pt
その点がツールに外接する四角形の内部にあれば、その点の座標を示します。ti
ツールについての情報。 TOOLINFO 構造体の詳細については、「CToolTipCtrl::GetToolInfo」を参照してください。
必要条件
**ヘッダー:**afxcmn.h