ФУНКЦИИ ДЛЯ ИМИТАЦИИ ВВОДА ДАННЫХ ПОЛЬЗОВАТЕЛЕМ

Функция keybd_event 

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

Windows NT/2000/XP: Эта функция была заменена. Используйте SendInput вместо нее.

Синтаксис

VOID keybd_event(           BYTE bVk,     BYTE bScan,     DWORD dwFlags,     PTR dwExtraInfo );

Параметры

bVk

[in] Определяет код виртуальной клавиши. Код должен быть значением в диапазоне от 1 до 254. Полный список  см. в статье Коды виртуальных клавиш.

bScan

Этот параметр не используется.

 dwFlags

[in] Определяет различные виды операций функции. Этот параметр может состоять из одного или нескольких ниже следующих  значений.

dwExtraInfo

[in] Определяет дополнительное значение, связанное с нажатием клавиши.

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

У этой функции нет возвращаемых значений.

Замечания

Прикладная программа может смоделировать нажатие клавиши PrintScreen, чтобы получить снимок экрана и сохранить его в буфере обмена. Чтобы сделать это, вызовите keybd_event с установленным параметром bVk в VK_SNAPSHOT.

Windows NT/2000/XP: Функция keybd_event может переключить клавиши NUM LOCK, CAPS LOCK и SCROLL LOCK.

Windows 95/98/Me: Функция keybd_event может переключить только клавиши CAPS LOCK и SCROLL LOCK. Она не может переключить клавишу NUM LOCK.

Ниже следующее типовая программа переключает индикатор NUM LOCK, используя функцию keybd_event () виртуальной клавишей VK_NUMLOCK. Требуется Булево значение, которое указывает, должен ли индикатор быть выключен - (ЛОЖЬ (FALSE)) или включен - (ИСТИНА (TRUE)). Та же самая методика может использоваться для клавиши CAPS LOCK (VK_CAPITAL)  и клавиши SCROLL LOCK (VK_SCROLL).

Показываем пример

Функция mouse_event

Функция mouse_event синтезирует движение мыши и щелчки кнопки.

Windows NT/2000/XP: Эта функция была заменена. Вместо нее используйте функцию SendInput.

Синтаксис

VOID mouse_event(           DWORD dwFlags,     DWORD dx,     DWORD dy,     DWORD dwData,     ULONG_PTR dwExtraInfo );

Параметры

dwFlags

[in] Устанавливает различные аспекты движения мыши и щелчков кнопки. Этот параметр может быть некоторой комбинацией нижеследующих значений.

Значения, которые определяют состояние кнопки мыши, устанавливаются, чтобы указать изменения в статусе, но  не для непрерывных состояний. Например, если левая кнопка мыши нажимается и удерживается нажатой, устанавливается MOUSEEVENTF_LEFTDOWN, в первый момент когда левая кнопка нажата, но не для последующих действий. Точно так же MOUSEEVENTF_LEFTUP устанавливается только в начале, когда кнопка отпущена.

Вы не можете в параметре dwFlags одновременно установить и MOUSEEVENTF_WHEEL и, или MOUSEEVENTF_XDOWN, или MOUSEEVENTF_XUP, потому что они оба требуют использования поля dwData.

 

dx

[in] Устанавливает абсолютную позицию мыши по оси X или по ее величине продвижения, с тех пор, как было произведено последнее событие мыши, которая зависит от установки флажка MOUSEEVENTF_ABSOLUTE. Абсолютные данные определяются как фактическая x-координата мыши; относительные данные определяются как перемещение на определенное число мики. Мики (mickey) - это величина, на которую должна продвинуться мышь, чтобы она сообщила, что состоялось перемещение.

dy

[in] Устанавливает абсолютную позицию мыши по оси Y или по ее величине продвижения, с тех пор, как было произведено последнее событие мыши, которая зависит от установки флажка MOUSEEVENTF_ABSOLUTE. Абсолютные данные определяются как фактическая y-координата мыши; относительные данные определяются как перемещение на определенное число мики.

dwData

[in] Если dwFlags содержит MOUSEEVENTF_WHEEL, то параметр dwData устанавливает величину перемещения колесика. Положительное значение указывает на то, что колесико вращалось вперед, в сторону от пользователя; отрицательное значение указывает, что колесико вращалось назад, к пользователю. Один щелчок (прим. перевод. храповика) колесика определяется как WHEEL_DELTA, число которых - 120.

Windows 2000/XP: Если параметр dwFlags содержит MOUSEEVENTF_XDOWN или MOUSEEVENTF_XUP, то dwData определяет, какие X-кнопки нажимались или отпускались. Это значение может быть любой комбинацией ниже перечисленных флажков.

Если параметр dwFlags - не MOUSEEVENTF_WHEEL, MOUSEEVENTF_XDOWN, или MOUSEEVENTF_XUP, то dwData должен равняться нулю.

dwExtraInfo

[in] Устанавливает дополнительное значение, связанное с событием мыши. Приложение вызывает функцию GetMessageExtraInfo, чтобы получить эту дополнительную информацию.

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

У этой функции нет возвращаемого значения.

Замечания

Если мышь двигалась, то установка флажка MOUSEEVENTF_MOVE указывает, что параметры  dx и dy содержат информацию об этом движении. Информация определяется как абсолютные или относительные целочисленное значения.

Если устанавливается значение MOUSEEVENTF_ABSOLUTE,  dx и dy содержат нормализованные абсолютные координаты между 0 и 65 535. Процедура события преобразует эти координаты для поверхности экрана. Координата (0,0) проецируется на левый верхний угол поверхности экрана, (65535,65535) проецируется на правый нижний угол.

Если значение MOUSEEVENTF_ABSOLUTE не установлено, dx и dy определяют относительные перемещения от того, когда было произведено последнее событие мыши (последняя сообщенная позиция). Положительные значения подразумевают, что мышь перемещалась вправо (или вниз); отрицательные значения подразумевают, что мышь двигалась влево (или вверх).

Относительное движение мыши подчинено настройкам скорости мыши и уровня ускорения. Конечный пользователь устанавливает эти величины, используя программу Mouse (Мышь) в Панели управления (Control Panel). Приложение получает и устанавливает эти значения при помощи функции SystemParametersInfo.

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

Как только было применено ускорение, система масштабирует получающуюся в результате величину требуемой скорости мыши. Скорость мыши может быть в диапазоне от 1 (самая медленная) до 20 (самая быстрая) и представляет величину, на котроую переместился указатель, базируясь на расстоянии, на которое перемещается мышь. Заданное по умолчанию значение равно 10, которое не приводит к дополнительной модификации движения мыши.

Функция mouse_event используется, чтобы синтезировать события мыши прикладными программами, которым необходимо так делать. Она также используется и прикладными программами, которые должны получать больше информации от мыши, а не только о ее позиции и состоянии кнопки. Например, если изготовитель планшета хочет передавать информацию, основанную на перьевом вводе данных, своим собственным программам, он может написать динамически подключаемую библиотеку (DLL), которая связывается непосредственно с аппаратными средствам планшета, получает дополнительную информацию и сохраняет ее в очереди. DLL затем вызывает функцию mouse_event при помощи стандартной кнопки и x/y данными местоположения, наряду с параметром dwExtraInfo с каким-то указателем или индексом поставленной в очередь дополнительной информации. Когда прикладная программа нуждается в дополнительной информации, она вызывает DLL с указателем или индексом, сохраненным в dwExtraInfo, и динамически подключаемая библиотека (DLL) возвращает дополнительную информацию.

Функция SendInput

Функция SendInput синтезирует нажатия клавиши, движения  и щелчки кнопкой мыши.

Синтаксис

UINT SendInput(           UINT nInputs,     LPINPUT pInputs,     int cbSize );

Параметры

nInputs

[in] Устанавливает число структур в массиве pInputs.

pInputs

[in] Указатель на массив структур INPUT. Каждая структура обозначает событие, которое будет вставлено во входной  поток клавиатуры или мыши .

cbSize

[in] Устанавливает размер, в байтах, структуры INPUT. Если параметр cbSize - не размер структуры INPUT, функция завершится ошибкой.

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

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

Чтобы получить дополнительные сведения об ошибке, вызовите функцию GetLastError.

Замечания

Функция SendInput вставляет события в структуры INPUT последовательно во входной поток мыши или клавиатуры. Эти события не вставляются в промежутки другой клавиатурой или мышью между вставленными событиями ввода данных  или пользователем ( клавиатурой или мышью) или вызовами функций keybd_event, mouse_event, или другими вызовами SendInput.

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

Структура INPUT

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

Синтаксис

typedef struct tagINPUT {   DWORD type;   union {MOUSEINPUT mi;             KEYBOARDINPUT ki;             HARDWAREINPUT hi;            };   }INPUT, *PINPUT;

Члены структуры

type

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

mi

Структура MOUSEINPUT, которая содержит информацию об имитируемом событии  нажатия кнопки мыши.

ki

Структура KEYBDINPUT, которая содержит информацию об имитируемом событии клавиатуры.

hi

Windows 95/98/Me: Структура HARDWAREINPUT, которая содержит информацию об имитируемом событии аппаратного ввода данных, а не  клавиатуры или мыши.

Замечания

Эта структура содержит информацию идентичную той, которая  используется в списке параметров функции mouse_event или keybd_event.

 Windows 2000/XP: Флажок INPUT_KEYBOARD поддерживает методы ввода данных не клавиатуры, такое как распознавание рукописи  или речи, как будто это был текстовой ввод, используя флажок KEYEVENTF_UNICODE. Для получения дополнительной информации, см. раздел замечаний структуры KEYBDINPUT.

Структура MOUSEINPUT 

Структура MOUSEINPUT содержит информацию об имитируемом событии нажатия кнопки мыши.

Синтаксис

typedef struct tagMOUSEINPUT {     LONG  dx;     LONG  dy;     DWORD  mouseData;     DWORD  dwFlags;     DWORD  time;     ULONG_PTR  dwExtraInfo; } MOUSEINPUT, *PMOUSEINPUT;

Члены структуры

dx

Устанавливает абсолютную позицию мыши или величину движения, с тех пор как было сгенерировано последнее событие нажатия мыши , в зависимости от значения члена структуры dwFlags . Абсолютные данные определяются как координата x мыши; относительные данные задаются как число пройденных пикселей.

dy

Устанавливает абсолютную позицию мыши или величину движения, с тех пор как было сгенерировано последнее событие нажатия мыши , в зависимости от значения члена структуры dwFlags . Абсолютные данные определяются как координата y мыши; относительные данные задаются как число пройденных пикселей.

mouseData

Если член структуры dwFlags содержит флажок MOUSEEVENTF_WHEEL, то параметр mouseData устанавливает величину перемещения колесика мыши. Положительное значение обозначает, что колесо вращалось вперед от пользователя; отрицательное значение обозначает то, что колесо вращалось обратно к пользователю. Один щелчок колеса определяется как WHEEL_DELTA, который равен 120.

Windows 2000/XP: Если член  структуры dwFlags не содержит флажка  MOUSEEVENTF_WHEEL, MOUSEEVENTF_XDOWN или MOUSEEVENTF_XUP, то параметр mouseData должен равняться нулю.

Если dwFlags содержит флажок  MOUSEEVENTF_XDOWN или MOUSEEVENTF_XUP, то параметр mouseData устанавливает, какие кнопки X были нажаты или отпущены. Это значение может быть любой комбинацией ниже следующее флажков.

dwFlags

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

Битовые флажки, которые определяют состояние кнопки мыши, устанавливаются так, чтобы указать изменения в состоянии, в условиях непродолжительного движения. Например, если левая кнопка мыши нажата и удерживается, флажок MOUSEEVENTF_LEFTDOWN устанавливается тогда, когда сначала нажата левосторонняя кнопка , а не для последующих движений. Точно так же MOUSEEVENTF_LEFTUP устанавливается только тогда, когда кнопка сначала отпущена.

Вы не можете установить ни флажок MOUSEEVENTF_WHEEL, ни флажки или MOUSEEVENTF_XDOWN или  MOUSEEVENTF_XUP одновременно в параметре dwFlags, потому что они оба требуют использования поля mouseData .

 time

Отметка времени для события, в миллисекундах. Если этот параметр - 0, система предоставит свою собственную отметку времени.

dwExtraInfo

Устанавливает дополнительное значение, связанное с событием  нажатия кнопки мыши. Приложение вызывает функцию GetMessageExtraInfo, чтобы получить эту дополнительную информацию.

Замечания

Если мышь переместилась, обозначив флажок MOUSEEVENTF_MOVE, члены dx и dy  определяют информацию об этом перемещении. Информация устанавливается как абсолютные или относительные целочисленные значения.

Если установлено значение MOUSEEVENTF_ABSOLUTE, поля структуры dx и dy содержат нормализованные абсолютные координаты между 0 и 65 535. Процедура события наносит эти координаты на поверхность отображения. Координата (0,0) наносится в левый верхний угол поверхности отображения; координата (65535,65535) наносится в  нижний правый угол. Во много экранной системе координаты наносятся  на главный монитор.

Windows 2000/XP: Если установлен флажок MOUSEEVENTF_VIRTUALDESK    координат наносятся на весь виртуальный рабочий стол.

Если значение MOUSEEVENTF_ABSOLUTE не установлено, dx и dy задают перемещение относительно предыдущего события мыши (последняя фиксируемая позиция). Положительные значения означают  перемещения мыши вправо (или вниз); отрицательные значения означают перемещение мыши влево (или вверх).

Относительное движение мыши подчиненно эффектам быстродействия мыши и порогового значения с двойного щелчка кнопкой мыши. Пользователь устанавливает эти три значения ползунком Скорость перемещения указателя (Pointer Speed) вкладки Свойств Мыши (Mouse Properties) на Панели управления (Windows). Вы можете получать и устанавливать эти значения, используя функцию SystemParametersInfo.

Система применяется два теста к заданному относительному перемещению мыши. Если определяемый интервал или по x или оси y больше, чем первое значение порога мыши, а быстродействие мыши - не нулевое, система удваивает интервал. Если заданный интервал или по оси x или по оси y больше чем второе значение порога мыши, а быстродействие мыши равно два, система удваивает интервал, который следовал из применения первого порогового теста. Таким образом это дает возможность системе  умножить заданное относительное перемещение мыши по оси x или оси y в четыре раза.

Структура KEYBDINPUT

Структура KEYBDINPUT содержит информацию об имитируемом событии клавиатуры.

Синтаксис

typedef struct tagKEYBDINPUT {     WORD  wVk;     WORD  wScan;     DWORD  dwFlags;     DWORD  time;     ULONG_PTR  dwExtraInfo; } KEYBDINPUT, *PKEYBDINPUT;

Члены структуры

wVk

Устанавливает код виртуальной клавиши. Код должен быть значением в диапазоне 1 - 254. Заголовочный файл Winuser.h предоставляет на каждое значение макроопределения (VK_ *). Если член структуры dwFlags  определяется как KEYEVENTF_UNICODE,  член структуры wVk должен быть 0.

wScan

Устанавливает аппаратный скэн-код для клавиши. Если член структуры dwFlags  определяется как KEYEVENTF_UNICODE, член структуры wScan определяет символ Unicode, который должен отправиться  активному приложению.

dwFlags

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

time

Отметка времени для события, в миллисекундах. Если этот параметр равняется нулю, система предоставляет свою собственную отметку времени.

dwExtraInfo

Устанавливает дополнительное значение, связанное с нажатием клавиши. Используйте функцию GetMessageExtraInfo, чтобы получить эту информацию.

Замечания

Windows 2000/XP: Флажок INPUT_KEYBOARD поддерживает  не клавиатурные методы ввода данных такие как распознавание почерка или распознавание голоса, как будто это был текстовой ввод, используя флажок KEYEVENTF_UNICODE. Если KEYEVENTF_UNICODE устанавливается, функция SendInput отправляет сообщение WM_KEYDOWN или WM_KEYUP  в очередь сообщений активного потока с параметром wParam, равным VK_PACKET. Как только функция GetMessage или PeekMessage получает это сообщение, оно переправляется в функцию TranslateMessage, которое посылает сообщение WM_CHAR  с символом Unicode, первоначально заданным параметром wScan. Этот символ Unicode будет автоматически преобразован в соответствующее значение ANSI, если сообщение посылается к окну ANSI.

Windows 2000/XP: Установка флажка KEYEVENTF_SCANCODE определяет ввод с клавиатуры в терминах скэн-кода. Это практикуется при имитации физического нажатия клавиши, независимо от того используется или нет  клавиатура в настоящий момент. Значение виртуальной клавиши клавиши может измениться в зависимости от текущей раскладки клавиатуры или от того, что другие клавиши были нажаты, но скэн-код всегда будет тот же самый.

Структура HARDWAREINPUT

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

Синтаксис

typedef struct tagHARDWAREINPUT {     DWORD  uMsg;     WORD  wParamL;     WORD  wParamH; } HARDWAREINPUT, *PHARDWAREINPUT;

Члены структуры

uMsg

Значение, задающее сообщение, созданное  аппаратными средствами ввода.

wParamL

Устанавливает младшее слово параметра lParam  для uMsg.

wParamH

Устанавливает старшее слово параметра lParam  для uMsg.

Коды виртуальных клавиш

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