Compartilhar via


CToolTipCtrl::HitTest

Testa para determinar se um ponto está dentro do retângulo delimitador de determinada ferramenta e, em caso afirmativo, recuperam informações sobre a ferramenta.

BOOL HitTest( 
   CWnd* pWnd, 
   CPoint pt, 
   LPTOOLINFO lpToolInfo  
) const;

Parâmetros

  • pWnd
    Ponteiro para a janela que contém a ferramenta.

  • pt
    Ponteiro para um objeto de CPoint que contém as coordenadas do ponto a ser testado.

  • lpToolInfo
    Ponteiro para a estrutura de TOOLINFO que contém informações sobre a ferramenta.

Valor de retorno

Diferente de zero se o ponto especificado pela informação sucessos-teste está dentro do retângulo delimitador de ferramenta; se não 0.

Comentários

Se essa função retorna um valor diferente de zero, a estrutura apontada por lpToolInfo está preenchida com informações na ferramenta cujo dentro do retângulo o ponto está.

a estrutura de TTHITTESTINFO é definida como segue:

typedef struct _TT_HITTESTINFO { // tthti

HWND hwnd; // handle of tool or window with tool

POINT pt; // client coordinates of point to test

TOOLINFO ti; // receives information about the tool

} TTHITTESTINFO, FAR * LPHITTESTINFO;

  • hwnd
    Especifica o identificador de ferramenta.

  • pt
    Especifica as coordenadas de um ponto se o ponto está no retângulo delimitador de ferramenta.

  • ti
    Informações sobre a ferramenta. Para obter mais informações sobre a estrutura de TOOLINFO , consulte CToolTipCtrl::GetToolInfo.

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe CToolTipCtrl

Gráfico da hierarquia

CToolTipCtrl::GetToolInfo