Функция TrackMouseEvent

Функция 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz