Функция TrackMouseEvent посылает сообщения, когда указатель мыши оставляет окно или нависает над окном на определенное количество времени.
Синтаксис
BOOL TrackMouseEvent( LPTRACKMOUSEEVENT lpEventTrack ); |
Параметры
lpEventTrack
[in, out] Указатель на структуру TRACKMOUSEEVENT, которая содержит отслеживаемую информацию.Возвращаемое значение
Если функция завершается успешно, возвращаемое значение не нуль.
Если функция завершается ошибкой, возвращаемое значение равняется нулю. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Функция может послать ниже перечисленные сообщения.
Сообщение Предназначение WM_NCMOUSEHOVER Windows 98/Me, Windows 2000/XP: То же самое предназначение, как и у WM_MOUSEHOVER - только для нерабочей области окна. WM_NCMOUSELEAVE Windows 98/Me, Windows 2000/XP: То же самое предназначение, что и у WM_MOUSELEAVE - только для нерабочей области окна. WM_MOUSEHOVER Мышь висела над рабочей областью окна в течение периода времени, указанного в предшествующем вызове функции TrackMouseEvent. Слежение за состоянием нависания останавливается тогда, когда создается это сообщение. Приложение должно вызвать TrackMouseEvent снова, если оно требует дальнейшего слежения за поведением мыши в висячем состоянии. WM_MOUSELEAVE Мышь покинула рабочую область окна, указанную в предшествующем вызове TrackMouseEvent. Все слежение, затребованное TrackMouseEvent отменяется, когда создается это сообщение. Приложение должно вызвать функцию TrackMouseEvent, когда мышь повторно входит в это окно, если оно требует дальнейшего слежения за поведением мыши в висячем состоянии..
Замечания
Находящийся в нависшем состоянии указатель мыши рассматривается тогда, когда он остается внутри определенного прямоугольника в течение заданного периода времени. Чтобы извлечь данные о размере прямоугольника и времени, вызовите функцию SystemParametersInfo и используйте значения SPI_GETMOUSEHOVERWIDTH, SPI_GETMOUSEHOVERHEIGHT и SPI_GETMOUSEHOVERTIME.
Обратите внимание! на то, что функция _TrackMouseEvent вызывает функцию TrackMouseEvent, если таковая существует, в противном случае _TrackMouseEvent имитирует ее. Функция _TrackMouseEvent находится в заголовочном файле commctrl.h и экспортируется в COMCTRL32. DLL. |
Смотри также
Обзор Ввод данных от мыши, Функции, используемые мышью, SystemParametersInfo, _TrackMouseEvent, TRACKMOUSEEVENT
Размещение и совместимость TrackMouseEvent |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да версии 4.0 и выше |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Да |
Используемая библиотека |
User32.lib |
Заголовочный файл |
|
- объявлено в |
Winuser.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |