Функция TrackMouseEvent (winuser.h)

Статья
08/28/2023

Публикует сообщения, когда указатель мыши покидает окно или наносит указатель мыши на окно в течение указанного периода времени.

Примечание Функция _TrackMouseEvent вызывает TrackMouseEvent , если она существует, в противном случае _TrackMouseEvent эмулирует TrackMouseEvent.

Синтаксис

BOOL TrackMouseEvent(
  [in, out] LPTRACKMOUSEEVENT lpEventTrack
);

Параметры

[in, out] lpEventTrack

Тип: LPTRACKMOUSEEVENT

Указатель на структуру TRACKMOUSEEVENT , содержащую сведения об отслеживании.

Возвращаемое значение

Тип: BOOL

Если функция выполнена успешно, возвращается ненулевое значение .

Если функция завершается сбоем, возвращаемое значение равно нулю. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Указатель мыши считается наведенным, если он остается в пределах указанного прямоугольника в течение указанного периода времени. Вызовите SystemParametersInfo. и используют значения SPI_GETMOUSEHOVERWIDTH, SPI_GETMOUSEHOVERHEIGHT и SPI_GETMOUSEHOVERTIME , чтобы получить размер прямоугольника и время.

Функция может публиковать следующие сообщения.

Сообщение	Описание
WM_NCMOUSEHOVER	То же значение, что и WM_MOUSEHOVER за исключением этого, для неклиентной области окна.
WM_NCMOUSELEAVE	То же значение, что и WM_MOUSELEAVE за исключением этого, для неклиентной области окна.
WM_MOUSEHOVER	Указатель мыши наведен на клиентную область окна в течение периода времени, указанного в предыдущем вызове TrackMouseEvent. Отслеживание при наведении указателя останавливается при создании этого сообщения. Приложение должно снова вызвать TrackMouseEvent , если требуется дальнейшее отслеживание поведения наведения указателя мыши.
WM_MOUSELEAVE	Мышь вышла из клиентской области окна, указанной в предыдущем вызове TrackMouseEvent. Все отслеживание, запрошенное TrackMouseEvent , отменяется при создании этого сообщения. Приложение должно вызывать TrackMouseEvent при повторном вводе окна мыши, если требуется дальнейшее отслеживание поведения наведения указателя мыши.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-mouse-l1-1-0 (появилось в Windows 8)