CTreeCtrl::HitTest

Artigo
08/25/2010

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

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

Parâmetros

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

Valor de retorno

O identificador do item de modo de exibição de árvore que ocupa o ponto especificado ou NULO se nenhum item ocupa o ponto.

Comentários

Quando esta função é chamado, o pt parâmetro especifica as coordenadas do ponto de teste. A função retorna o identificador do item no ponto especificado ou NULO se nenhum item ocupa o ponto.Além disso, a pFlags parâmetro contém um valor que indica o local do ponto especificado.

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