CTreeCtrl::HitTest

Artículo
06/10/2015

Llame a esta función para determinar la ubicación del punto especificado en relación al área cliente de un control de vista de árbol.

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

Parámetros

pt
Coordenadas de cliente point en la prueba.
pFlags
Puntero a un entero que recibe información sobre los resultados de pruebas de posicionamiento. Puede ser uno o más de los valores enumerados en miembro de marcas en la sección comentarios.
pHitTestInfo
Dirección de una estructura de TVHITTESTINFO que contiene la posición a la prueba de posicionamiento y que recibe información sobre los resultados de pruebas de posicionamiento.

Valor devuelto

El identificador del elemento de vista de árbol que ocupa el punto especificado o NULL si ningún elemento ocupa el punto.

Comentarios

Cuando se llama a esta función, el parámetro de pt especifica las coordenadas point en la prueba. La función devuelve el identificador de elemento en el punto especificado o NULL si ningún elemento ocupa el punto. Además, el parámetro de pFlags contiene un valor que indica la ubicación del punto especificado. Los valores posibles son:

Valor	Significado
TVHT_ABOVE	Sobre el área cliente.
TVHT_BELOW	Debajo del área cliente.
TVHT_NOWHERE	En el área cliente, pero en el último elemento.
TVHT_ONITEM	En el mapa de bits o la etiqueta asociada a un elemento.
TVHT_ONITEMBUTTON	En el botón asociado a un elemento.
TVHT_ONITEMICON	En el mapa de bits asociado a un elemento.
TVHT_ONITEMINDENT	En la sangría asociada a un elemento.
TVHT_ONITEMLABEL	En la etiqueta (cadena) asociada a un elemento.
TVHT_ONITEMRIGHT	En el área situada a la derecha de un elemento.
TVHT_ONITEMSTATEICON	En el icono de estado de un elemento de vista de árbol que está en un estado definido por el usuario.
TVHT_TOLEFT	A la izquierda del área cliente.
TVHT_TORIGHT	A la derecha del área cliente.

Ejemplo

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