CTreeCtrl::HitTest

Articolo
02/19/2013

Chiamare la funzione per determinare la posizione del punto specificato relativo all'area client di un controllo di visualizzazione ad albero.

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

Parametri

pt
Coordinate del punto da testare.
pFlags
Puntatore a un intero che riceve informazioni sui risultati dell'hit test.Può essere uno o più dei valori elencati sotto il membro flag nella sezione relativa alle osservazioni.
pHitTestInfo
Indirizzo di una struttura TVHITTESTINFO contenente la posizione a hit testing e che riceve informazioni sui risultati dell'hit test.

Valore restituito

Gli handle dell'elemento della visualizzazione struttura ad albero in cui è contenuto il punto specificato o NULL se nessun elemento occupi il punto.

Note

Quando questa funzione viene chiamata, il parametro pt specifica le coordinate del punto di test.La funzione restituisce un handle dell'elemento sul punto specificato o a NULL se nessun elemento occupi il punto.Inoltre, il parametro pFlags contiene un valore che indica la posizione del punto specificato.Di seguito sono riportati i valori possibili:

Valore	Significato
TVHT_ABOVE	Nell'area client.
TVHT_BELOW	Nell'area client.
TVHT_NOWHERE	Nell'area client, ma nell'ultimo elemento.
TVHT_ONITEM	La bitmap o sull'etichetta associata a un elemento.
TVHT_ONITEMBUTTON	Sul pulsante associato a un elemento.
TVHT_ONITEMICON	La bitmap associata a un elemento.
TVHT_ONITEMINDENT	Il rientro associato a un elemento.
TVHT_ONITEMLABEL	Nell'etichetta (stringa) associata a un elemento.
TVHT_ONITEMRIGHT	Nell'area a destra di un elemento.
TVHT_ONITEMSTATEICON	Sull'icona di stato per un elemento di visualizzazione struttura ad albero che si trova in uno stato definito.
TVHT_TOLEFT	Nell'area client.
TVHT_TORIGHT	A destra dell'area client.

Esempio

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