Поделиться через


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

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

Примечание Функция _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)

См. также раздел

Основные понятия

Ввод с помощью мыши

Другие ресурсы

Справочные материалы

SystemParametersInfo

TRACKMOUSEEVENT

_TrackMouseEvent