CTreeCtrl::HitTest

Article
03/04/2013

Appelez cette fonction pour déterminer l'emplacement du point spécifié par rapport à la zone cliente d'un contrôle arborescence.

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

Paramètres

pt
Coordonnées clientes du point de test.
pFlags
Pointeur vers un entier qui reçoit des informations sur les résultats du test de positionnement.Il peut être un ou plusieurs des valeurs répertoriées sous le membre de indicateurs dans la section Notes.
pHitTestInfo
Adresse d'une structure de TVHITTESTINFO contenant la position du test de positionnement et qui reçoit des informations sur les résultats du test de positionnement.

Valeur de retour

Le handle de l'élément d'arborescence qui occupe le point spécifié ou NULL si aucun élément n'occupe le débogage.

Notes

Lorsque cette fonction est appelée, le paramètre d' pt spécifie les coordonnées du point de test.La fonction retourne le handle de l'élément à le point spécifié ou NULL si aucun élément n'occupe le débogage.En outre, le paramètre d' pFlags contient une valeur qui indique l'emplacement du point spécifié.Les valeurs possibles sont :

Valeur	Signification
TVHT_ABOVE	Au-dessus de la zone cliente.
TVHT_BELOW	Sous la zone cliente.
TVHT_NOWHERE	Dans la zone cliente, mais sous le dernier élément.
TVHT_ONITEM	Dans la bitmap ou l'étiquette associée à un élément.
TVHT_ONITEMBUTTON	Sur le bouton associé à un élément.
TVHT_ONITEMICON	Dans la bitmap associée à un élément.
TVHT_ONITEMINDENT	Dans la mise en retrait associée à un élément.
TVHT_ONITEMLABEL	Sous l'étiquette (chaîne) associée à un élément.
TVHT_ONITEMRIGHT	Dans la zone située à droite d'un élément.
TVHT_ONITEMSTATEICON	Sur l'icône d'état d'un élément d'arborescence qui est dans un état défini par l'utilisateur.
TVHT_TOLEFT	À gauche de la zone cliente.
TVHT_TORIGHT	À droite de la zone cliente.

Exemple

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