CTreeCtrl::HitTest

CTreeCtrl::HitTest

 

調用此函數肯定指定的位置點相對樹視圖控件的工做區的。

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

參數

 

  pt

測試的點工做區座標。

pFlags

爲獲取有關命中測試的結果的信息的整數的指針測試。 它能夠是一個或多個值列表的"備註"部分的 flags 成員下。

pHitTestInfo

包含該位置命中 TVHITTESTINFO 結構的地址測試和獲取有關命中測試的結果的信息。

返回值

 

  所指定的樹視圖項目中處理點或 NULL，若是項目不佔據點。

備註

 

  當調用該函數時時，pt 參數指定點的座標測試。 若是項目不佔據點，該函數返回指定的項的處理點或 NULL。 此外，pFlags 參數包含一個值來指定點的位置。 可能的值包括：

 

Value	含義
TVHT_ABOVE	在客戶端區域。
TVHT_BELOW	在工做區中。
TVHT_NOWHERE	在工做區，可是，在最後一項下。
TVHT_ONITEM	在位圖或標籤與項目。
TVHT_ONITEMBUTTON	在按鈕上與項目。
TVHT_ONITEMICON	在位圖與項目。
TVHT_ONITEMINDENT	在縮進與項目。
TVHT_ONITEMLABEL	在標籤(字符串)與項目。
TVHT_ONITEMRIGHT	在項目右邊的區域。
TVHT_ONITEMSTATEICON	在一個用戶定義狀態的樹視圖項的狀態圖標。
TVHT_TOLEFT	在工做區左邊。
TVHT_TORIGHT	在工做區的右側。

示例

 

  C++

 

// 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