Condividi tramite


CTreeCtrl::HitTest

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

Requisiti

Header: afxcmn.h

Vedere anche

Riferimenti

Classe di CTreeCtrl

Grafico della gerarchia

CTreeCtrl::GetItemRect