Função TrackMouseEvent (winuser.h)
Posta mensagens quando o ponteiro do mouse sai de uma janela ou passa o mouse sobre uma janela por um período especificado.
Sintaxe
BOOL TrackMouseEvent(
[in, out] LPTRACKMOUSEEVENT lpEventTrack
);
Parâmetros
[in, out] lpEventTrack
Tipo: LPTRACKMOUSEEVENT
Um ponteiro para uma estrutura TRACKMOUSEEVENT que contém informações de acompanhamento.
Valor retornado
Tipo: BOOL
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
O ponteiro do mouse é considerado focalizado quando permanece dentro de um retângulo especificado por um período de tempo especificado. Chame SystemParametersInfo. e usam os valores SPI_GETMOUSEHOVERWIDTH, SPI_GETMOUSEHOVERHEIGHT e SPI_GETMOUSEHOVERTIME para recuperar o tamanho do retângulo e a hora.
A função pode postar as mensagens a seguir.
| Mensagem | Descrição |
|---|---|
| WM_NCMOUSEHOVER | O mesmo significado que WM_MOUSEHOVER , exceto que isso é para a área não cliente da janela. |
| WM_NCMOUSELEAVE | O mesmo significado que WM_MOUSELEAVE , exceto que isso é para a área não cliente da janela. |
| WM_MOUSEHOVER | O mouse passou o mouse sobre a área do cliente da janela pelo período de tempo especificado em uma chamada anterior a TrackMouseEvent. O controle de foco é interrompido quando essa mensagem é gerada. O aplicativo deve chamar TrackMouseEvent novamente se exigir acompanhamento adicional do comportamento de foco do mouse. |
| WM_MOUSELEAVE | O mouse deixou a área do cliente da janela especificada em uma chamada anterior para TrackMouseEvent. Todo o acompanhamento solicitado por TrackMouseEvent é cancelado quando essa mensagem é gerada. O aplicativo deve chamar TrackMouseEvent quando o mouse entra novamente em sua janela caso seja necessário um acompanhamento adicional do comportamento de foco do mouse. |
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib |
| DLL | User32.dll |
| Conjunto de APIs | ext-ms-win-ntuser-mouse-l1-1-0 (introduzido no Windows 8) |
Confira também
Conceitual
Outros recursos
Referência