共用方式為


CTreeCtrl::HitTest

呼叫此函式以判斷指定點的位置 (相對於樹狀檢視控制項的工作區。

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

參數

  • pt
    要測試的點的工作區座標。

  • pFlags
    要取得有關點擊測試結果的資訊之整數的指標。 它可以是一個或多個值清單"備註"一節中的 flags 成員底下。

  • pHitTestInfo
    包含這個位置進行點擊測試,並取得與點擊測試結果的詳細資訊 TVHITTESTINFO 結構的位址。

傳回值

取得指定的點或 NULL 樹狀檢視項目的控制代碼,如果項目不會佔用點。

備註

當呼叫這個函式時, pt 參數指定這個點的座標測試。 不過,如果項目不會佔用點,函式會傳回項目的控制代碼在指定的點或 NULL 。 此外, pFlags 參數包含表示指定的點位置的值。 可能值為:

意義

TVHT_ABOVE

在工作區中的項目。

TVHT_BELOW

在工作區中。

TVHT_NOWHERE

在工作區,不過,在最後一個項目的下方。

TVHT_ONITEM

在點陣圖或標籤相關聯的項目。

TVHT_ONITEMBUTTON

在按鈕上與項目。

TVHT_ONITEMICON

在點陣圖相關聯的項目。

TVHT_ONITEMINDENT

在縮排與項目。

TVHT_ONITEMLABEL

在標籤 (字串) 相關聯的項目。

TVHT_ONITEMRIGHT

在項目右邊的區域中。

TVHT_ONITEMSTATEICON

在一個使用者定義的狀態的樹狀檢視項目的狀態圖示。

TVHT_TOLEFT

在工作區左邊。

TVHT_TORIGHT

在工作區的右邊。

範例

// 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);
}

需求

Header: afxcmn.h

請參閱

參考

CTreeCtrl 類別

階層架構圖

CTreeCtrl::GetItemRect