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