CTreeCtrl::HitTest

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ツリービューコントロールのクライアント領域からの相対で指定された点の位置を調べます。

HTREEITEM HitTest(
   CPoint pt,
   UINT* pFlags = NULL
) const;
HTREEITEM HitTest(
   TVHITTESTINFO* pHitTestInfo 
) const;

パラメータ

pt
テストする点のクライアント座標。
pFlags
ヒットテストの結果についての情報を受け取る整数へのポインタ。「解説」に示されている「flags」メンバの値の 1 つ、またはそれらを組み合わせた値です。
pHitTestInfo
ヒットテストする位置を保持し、ヒットテストの結果の情報を受け取る TVHITTESTINFO 構造体のアドレス。

戻り値

指定した点を含むツリービューアイテムのハンドルを返します。その点を含むアイテムがない場合は NULL を返します。

解説

この関数を呼び出すときは、パラメータ pt にテストされる点の座標を指定します。関数は、指定された点にあるアイテムのハンドルを返します。指定された点にアイテムがない場合は NULL を返します。さらに、パラメータ pFlags には指定された点の位置を示す値が格納されます。

使用例

// Select the item that is at the point myPoint.
UINT uFlags;
HTREEITEM hItem = m_TreeCtrl.HitTest(myPoint, &uFlags);

if ((hItem != NULL) && (TVHT_ONITEM & uFlags))
{
   m_TreeCtrl.SelectItem(hItem);
}