Função TrackMouseEvent (winuser.h)

Artigo
08/28/2023

Posta mensagens quando o ponteiro do mouse sai de uma janela ou passa o mouse sobre uma janela por um período especificado.

Nota A função _TrackMouseEvent chama TrackMouseEvent se existir, caso contrário , _TrackMouseEvent emula TrackMouseEvent.

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)