CTreeCtrl::HitTest

Artigo
02/25/2013

Chamar essa função para determinar o local de ponto especificado em relação à área cliente de um controle de exibição de árvore.

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

Parâmetros

pt
Coordenadas do cliente de ponto para testar.
pFlags
Ponteiro para um número inteiro que puxar informações sobre os resultados de teste de clique.Pode ser um ou mais dos valores listados no membro de flags na seção comentários.
pHitTestInfo
Endereço de uma estrutura de TVHITTESTINFO que contém a posição fazer teste e que recebe informações sobre os resultados de teste de clique.

Valor de retorno

A alça de item do modo de exibição de árvore que ocupa o ponto especificado ou NULO se nenhum item ocupa o ponto.

Comentários

Quando essa função é chamada, o parâmetro de pt especifica as coordenadas do ponto para teste.A função retorna a alça do item no ponto especificado ou em NULO se nenhum item ocupa o ponto.Além de isso, o parâmetro de pFlags contém um valor que indica o local de ponto especificado.Os valores possíveis são:

Valor	Significado
TVHT_ABOVE	Acima da área cliente.
TVHT_BELOW	Abaixo da área cliente.
TVHT_NOWHERE	Em a área cliente, mas abaixo do último item.
TVHT_ONITEM	Em o bitmap ou no rótulo associado a um item.
TVHT_ONITEMBUTTON	Em o botão associados com um item.
TVHT_ONITEMICON	Em o bitmap associados com um item.
TVHT_ONITEMINDENT	Em o recuo associados com um item.
TVHT_ONITEMLABEL	Em o rótulo (cadeia de caracteres) associada a um item.
TVHT_ONITEMRIGHT	Em a área à direita de um item.
TVHT_ONITEMSTATEICON	Em o ícone do estado de um item de modo de exibição de árvore que está em um estado definido pelo usuário.
TVHT_TOLEFT	A a esquerda da área cliente.
TVHT_TORIGHT	A a direita da área cliente.

Exemplo

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