Partager via


CTreeCtrl::HitTest

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

Configuration requise

Header: afxcmn.h

Voir aussi

Référence

Classe de CTreeCtrl

Graphique de la hiérarchie

CTreeCtrl::GetItemRect