CTreeCtrl::HitTest
Bir ağaç görünümü denetiminin belirtilen noktasına göre istemci alanının konumunu belirlemek için bu işlevini çağırın.
HTREEITEM HitTest(
CPoint pt,
UINT* pFlags = NULL
) const;
HTREEITEM HitTest(
TVHITTESTINFO* pHitTestInfo
) const;
Parametreler
pt
Test etmek için noktanın koordinatlarını istemci.pFlags
Vuruş testi sonuçları hakkındaki bilgileri alır bir tamsayı için işaretçi.Bir olabilir ya da birden fazla değer altında listelenen bayrakları açıklamalar bölümüne üye.pHitTestInfo
Adres, bir TVHITTESTINFO test ve vuruş pozisyonu içeren yapısı vuruş testi sonuçları hakkındaki bilgileri alır.
Dönüş Değeri
Belirtilen noktası kaplayan ağaç görünümü öğesi tutamaç veya null hiçbir öğe noktası kaplıyorsa.
Notlar
Bu işlev çağrıldığında, pt parametresi, test etmek için noktanın koordinatlarını belirtir.İşlev belirtilen noktada öğesinin tanıtıcısı döndürür veya null hiçbir öğe noktası kaplıyorsa.Buna ek olarak, pFlags parametresi belirtilen noktasının konumunu belirten bir değer içerir.Olası değerler şunlardır:
Value |
Anlam |
TVHT_ABOVE |
İstemci alanının üstünde. |
TVHT_BELOW |
İstemci alanının altında. |
TVHT_NOWHERE |
İstemci alanında, ancak son öğenin altına. |
TVHT_ONITEM |
Bit eşlem veya bir öğeyle ilişkili etiket. |
TVHT_ONITEMBUTTON |
Bir öğeyle ilişkili bulunan düğme. |
TVHT_ONITEMICON |
Bir maddeyle bağlantılı bitmap üzerinde. |
TVHT_ONITEMINDENT |
Bir öğeyle ilişkili girinti içinde. |
TVHT_ONITEMLABEL |
Bir öğeyle ilişkili etiketi (dize). |
TVHT_ONITEMRIGHT |
Öğenin sağındaki alan. |
TVHT_ONITEMSTATEICON |
Bir ağaç görünümü öğesi için durum simgesi üzerinde bir kullanıcı tanımlı durumda. |
TVHT_TOLEFT |
İstemci alanının solunda. |
TVHT_TORIGHT |
İstemci alanının sağında. |
Örnek
// 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);
}
Gereksinimler
Başlık: afxcmn.h