Структура MOUSE_EVENT_RECORD

Статья
10/23/2023

Важно!

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

Описывает событие ввода мыши в структуре консоли INPUT_RECORD .

Синтаксис

typedef struct _MOUSE_EVENT_RECORD {
  COORD dwMousePosition;
  DWORD dwButtonState;
  DWORD dwControlKeyState;
  DWORD dwEventFlags;
} MOUSE_EVENT_RECORD;

Участники

dwMousePosition
Структура COORD, содержащая расположение курсора с точки зрения координат символьной ячейки буфера экрана консоли.

dwButtonState
Состояние кнопок мыши. Наименьший значительный бит соответствует самой левой кнопке мыши. Следующий наименьший значимый бит соответствует самой правой кнопке мыши. Следующий бит указывает кнопку мыши рядом с левой кнопкой мыши. Затем биты соответствуют слева направо на кнопки мыши. Бит 1, если кнопка была нажата.

Для первых пяти кнопок мыши определены следующие константы.

Значение	Значение
FROM_LEFT_1ST_BUTTON_PRESSED 0x0001	Самая левая кнопка мыши.
FROM_LEFT_2ND_BUTTON_PRESSED 0x0004	Вторая кнопка слева.
FROM_LEFT_3RD_BUTTON_PRESSED 0x0008	Третья кнопка слева.
FROM_LEFT_4TH_BUTTON_PRESSED 0x0010	Четвертая кнопка слева.
RIGHTMOST_BUTTON_PRESSED 0x0002	Самая правая кнопка мыши.

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

Значение	Значение
CAPSLOCK_ON 0x0080	Индикатор CAPS LOCK включен.
ENHANCED_KEY 0x0100	Ключ улучшен. См . примечания.
LEFT_ALT_PRESSED 0x0002	Нажата левая клавиша ALT.
LEFT_CTRL_PRESSED 0x0008	Нажата левая клавиша CTRL.
NUMLOCK_ON 0x0020	Индикатор NUM LOCK включен.
RIGHT_ALT_PRESSED 0x0001	Нажимается справа клавиша ALT.
RIGHT_CTRL_PRESSED 0x0004	Нажата правая клавиша CTRL.
SCROLLLOCK_ON 0x0040	Индикатор SCROLL LOCK включен.
SHIFT_PRESSED 0x0010	Клавиша SHIFT нажимается.

dwEventFlags
Тип события мыши. Если это значение равно нулю, оно указывает на нажатие или освобождение кнопки мыши. В противном случае этот элемент является одним из следующих значений.

Значение	Значение
DOUBLE_CLICK 0x0002	Второй щелчок (нажатие кнопки) при двойном щелчке. Первый щелчк возвращается как обычное событие нажатия кнопки.
MOUSE_HWHEELED 0x0008	Горизонтальное колесо мыши было перемещено. Если высокое слово элемента dwButtonState содержит положительное значение, колесо было повернуто справа. В противном случае колесо было повернуто влево.
MOUSE_MOVED 0x0001 0x0001	Произошло изменение положения мыши.
MOUSE_WHEELED 0x0004	Вертикальное колесо мыши было перемещено. Если высокое слово элемента dwButtonState содержит положительное значение, колесо было повернуто вперед, от пользователя. В противном случае колесо было повернуто назад, в сторону пользователя.

Замечания

События мыши помещаются в входной буфер, когда консоль находится в режиме мыши (ENABLE_MOUSE_INPUT).

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

Примеры

Пример см. в статье о чтении событий входного буфера.

Requirements


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхний колонтитул	WinConTypes.h (через WinCon.h, включите Windows.h)