TTM_HITTEST mensagem

Testa um ponto para determinar se ele está dentro do retângulo delimitador da ferramenta especificada e, se for, recupera informações sobre a ferramenta.

Parâmetros

wParam

Deve ser zero.

lParam

Ponteiro para uma estrutura TTHITTESTINFO . Ao enviar a mensagem, o membro hwnd deve especificar o identificador para uma ferramenta e o membro pt deve especificar as coordenadas de um ponto. Se o valor retornado for TRUE, o membro ti (uma estrutura TOOLINFO ) receberá informações sobre a ferramenta que ocupa o ponto. O membro cbSize da estrutura ti deve ser preenchido antes de enviar essa mensagem.

Valor retornado

Retornará TRUE se a ferramenta ocupar o ponto especificado ou FALSE caso contrário.

Comentários

Essa mensagem deve ser enviada quando a ferramenta tiver o sinalizador TTF_TRACK definido. Para obter mais informações sobre esse sinalizador, consulte TOOLINFO. TTM_HITTEST falhará se TTF_TRACK não estiver definido, independentemente se o ponto de ocorrência estiver no retângulo das ferramentas ou não.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Commctrl.h
Nomes Unicode e ANSI
TTM_HITTESTW (Unicode) e TTM_HITTESTA (ANSI)