CTreeCtrl::HitTest
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);
}
Requisitos
Cabeçalho: afxcmn.h