Compartilhar via


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.

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)

Confira também

Conceitual

Entrada por mouse

Outros recursos

Referência

SystemParametersInfo

TRACKMOUSEEVENT

_Trackmouseevent