сообщение WM_MOUSEWHEEL

Статья
01/06/2024

Отправляется в окно фокуса при повороте колесика мыши. Функция DefWindowProc распространяет сообщение на родительский элемент окна. Не должно быть внутренней пересылки сообщения, так как DefWindowProc распространяет его вверх по родительской цепочке, пока не обнаружит окно, которое обрабатывает его.

Окно получает это сообщение через функцию WindowProc .

#define WM_MOUSEWHEEL                   0x020A

Параметры

wParam

Слово высокого порядка указывает расстояние, которое колесо поворачивается, выражается в нескольких или делениях WHEEL_DELTA, что составляет 120. Положительное значение указывает, что колесо было повернуто вперед, в сторону от пользователя; Отрицательное значение указывает, что колесо было повернуто назад к пользователю.

Слово с низким порядком указывает, отключены ли различные виртуальные ключи. Этот параметр может быть одним или несколькими из следующих значений.

Значение	Значение
MK_CONTROL 0x0008	Клавиша CTRL вниз.
MK_LBUTTON 0x0001	Левая кнопка мыши вниз.
MK_МБ UTTON 0x0010	Средняя кнопка мыши вниз.
MK_RBUTTON 0x0002	Правая кнопка мыши вниз.
MK_SHIFT 0x0004	Клавиша SHIFT вниз.
MK_XBUTTON1 0x0020	Первая кнопка X вниз.
MK_XBUTTON2 0x0040	Вторая кнопка X вниз.

lParam

Слово с низким порядком указывает координату указателя x относительно левого верхнего угла экрана.

Слово с высоким порядком указывает координату указателя y относительно левого верхнего угла экрана.

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

Если приложение обрабатывает это сообщение, оно должно возвращать ноль.

Замечания

Используйте следующий код, чтобы получить сведения в параметре wParam :

fwKeys = GET_KEYSTATE_WPARAM(wParam);
zDelta = GET_WHEEL_DELTA_WPARAM(wParam);

Используйте следующий код для получения горизонтальной и вертикальной позиции:

xPos = GET_X_LPARAM(lParam); 
yPos = GET_Y_LPARAM(lParam);

Как отмечалось выше, координата x находится в низком порядке, чем возвращаемое значение; координата y находится в коротком формате высокого порядка (оба представляют подписанные значения, так как они могут принимать отрицательные значения в системах с несколькими мониторами). Если возвращаемое значение назначено переменной, можно использовать макрос MAKEPOINTS для получения структуры POINTS из возвращаемого значения. Вы также можете использовать макрос GET_X_LPARAM или GET_Y_LPARAM для извлечения координат x-или y.

Важно!

Не используйте макросы LOWORD или HIWORD для извлечения координат x-и y позиции курсора, так как эти макросы возвращают неверные результаты в системах с несколькими мониторами. Системы с несколькими мониторами могут иметь отрицательные координаты x и y, а LOWORD и HIWORD обрабатывают координаты как неподписанные количества.

Поворот колеса будет несколькими WHEEL_DELTA, который установлен в 120. Это пороговое значение для выполнения действий, и одно такое действие (например, прокрутка одного добавочного значения) должна выполняться для каждого разностного значения.

В разностном режиме было установлено значение 120, чтобы корпорация Майкрософт или другие поставщики могли создавать колеса тонкого разрешения (свободно вращающееся колесо без замечания), чтобы отправлять больше сообщений на поворот, но с меньшим значением в каждом сообщении. Чтобы использовать эту функцию, можно добавить входящие разностные значения, пока WHEEL_DELTA не будет достигнут (поэтому для разностного поворота вы получаете тот же ответ) или прокрутите частичные строки в ответ на более частые сообщения. Вы также можете выбрать степень детализации прокрутки и накапливать разностные значения, пока она не будет достигнута.

Обратите внимание, что для MSH_MOUSEWHEEL нет fwKeys. В противном случае параметры точно совпадают с WM_MOUSEWHEEL.

Приложение может пересылать MSH_MOUSEWHEEL в все внедренные объекты или элементы управления. Приложение требуется для отправки сообщения активному встроенному приложению OLE. Приложение отправляет его в элемент управления с поддержкой колес с фокусом. Если приложение отправляет сообщение в элемент управления, оно может проверка возвращаемое значение, чтобы узнать, было ли обработано сообщение. Элементы управления необходимы для возврата значения TRUE , если они обрабатывают сообщение.

Requirements

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхний колонтитул	Winuser.h (включая Windowsx.h)

См. также

Ссылка
GET_KEYSTATE_WPARAM
GET_X_LPARAM
GET_Y_LPARAM
GET_WHEEL_DELTA_WPARAM
HIWORD
LOWORD
mouse_event
Концептуальной
Ввод с помощью мыши
Другие ресурсы
GetSystemMetrics
MAKEPOINTS
ТОЧКИ
SystemParametersInfo

Share via