На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

mouse_event



The mouse_event function synthesizes mouse motion and button clicks.

VOID mouse_event(

DWORD dwFlags, // flags specifying various motion/click variants
DWORD dx, // horizontal mouse position or position change
DWORD dy, // vertical mouse position or position change
DWORD dwData, // amount of wheel movement
DWORD dwExtraInfo // 32 bits of application-defined information
);


Parameters

dwFlags

A set of flag bits that specify various aspects of mouse motion and button clicking. The bits in this parameter can be any reasonable combination of the following values:

Value Meaning
MOUSEEVENTF_ABSOLUTE Specifies that the dx and dy parameters contain normalized absolute coordinates. If not set, those parameters contain relative data: the change in position since the last reported position. This flag can be set, or not set, regardless of what kind of mouse or mouse-like device, if any, is connected to the system. For further information about relative mouse motion, see the following Remarks section.
MOUSEEVENTF_MOVE Specifies that movement occurred.
MOUSEEVENTF_LEFTDOWN Specifies that the left button changed to down.
MOUSEEVENTF_LEFTUP Specifies that the left button changed to up.
MOUSEEVENTF_RIGHTDOWN Specifies that the right button changed to down.
MOUSEEVENTF_RIGHTUP Specifies that the right button changed to up.
MOUSEEVENTF_MIDDLEDOWN Specifies that the middle button changed to down.
MOUSEEVENTF_MIDDLEUP Specifies that the middle button changed to up.
MOUSEEVENTF_WHEEL Windows NT only: Specifies that the wheel has been moved, if the mouse has a wheel. The amount of movement is given in dwData


The flag bits that specify mouse button status are set to indicate changes in status, not ongoing conditions. For example, if the left mouse button is pressed and held down, MOUSEEVENTF_LEFTDOWN is set when the left button is first pressed, but not for subsequent motions. Similarly, MOUSEEVENTF_LEFTUP is set only when the button is first released.

dx

Specifies the mouse's absolute position along the x-axis or its amount of motion since the last mouse event was generated, depending on the setting of MOUSEEVENTF_ABSOLUTE. Absolute data is given as the mouse's actual x-coordinate; relative data is given as the number of mickeys moved.

dy

Specifies the mouse's absolute position along the y-axis or its amount of motion since the last mouse event was generated, depending on the setting of MOUSEEVENTF_ABSOLUTE. Absolute data is given as the mouse's actual y-coordinate; relative data is given as the number of mickeys moved.

dwData

If dwFlags is MOUSEEVENTF_WHEEL, then dwData specifies the amount of wheel movement. A positive value indicates that the wheel was rotated forward, away from the user; a negative value indicates that the wheel was rotated backward, toward the user. One wheel click is defined as WHEEL_DELTA, which is 120.
If dwFlags is not MOUSEEVENTF_WHEEL, then dwData should be zero.

dwExtraInfo

Specifies an additional 32-bit value associated with the mouse event. An application calls GetMessageExtraInfo to obtain this extra information.



Return Values

This function has no return value.

Remarks

If the mouse has moved, indicated by MOUSEEVENTF_MOVE being set, dx and dy hold information about that motion. The information is given as absolute or relative integer values.
If MOUSEEVENTF_ABSOLUTE value is specified, dx and dy contain normalized absolute coordinates between 0 and 65,535. The event procedure maps these coordinates onto the display surface. Coordinate (0,0) maps onto the upper-left corner of the display surface, (65535,65535) maps onto the lower-right corner.

If the MOUSEEVENTF_ABSOLUTE value is not specified, dx and dy specify relative motions from when the last mouse event was generated (the last reported position). Positive values mean the mouse moved right (or down); negative values mean the mouse moved left (or up).
Relative mouse motion is subject to the effects of the mouse speed and the two mouse threshold values. In Windows NT, an end user sets these three values with the Mouse Tracking Speed slider of Control Panel's Mouse option; in Windows 95, an end user sets them with the Pointer Speed slider of the Control Panel's Mouse property sheet. An application obtains and sets these values with the SystemParametersInfo function.

The operating system applies two tests to the specified relative mouse motion. If the specified distance along either the x or y axis is greater than the first mouse threshold value, and the mouse speed is not zero, the operating system doubles the distance. If the specified distance along either the x or y axis is greater than the second mouse threshold value, and the mouse speed is equal to two, the operating system doubles the distance that resulted from applying the first threshold test. It is thus possible for the operating system to multiply relatively-specified mouse motion along the x or y axis by up to four times.

The mouse_event function is used to synthesize mouse events by applications that need to do so. It is also used by applications that need to obtain more information from the mouse than its position and button state. For example, if a tablet manufacturer wants to pass pen-based information to its own applications, it can write a dynamic-link library (DLL) that communicates directly to the tablet hardware, obtains the extra information, and saves it in a queue. The DLL then calls mouse_event with the standard button and x/y position data, along with, in the dwExtraInfo parameter, some pointer or index to the queued extra information. When the application needs the extra information, it calls the DLL with the pointer or index stored in dwExtraInfo, and the DLL returns the extra information.

See Also

GetMessageExtraInfo, SystemParametersInfo


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

mouse_event



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

ПУСТОТА mouse_event(

DWORD dwFlags, // ФЛАГИ, определяющие различное движение/щелчок вариантов DWORD dx, // горизонтальная позиция мыши или изменение позиции DWORD dy, // вертикальная позиция мыши или изменения позиции DWORD dwData, // суммы перемещения колеса DWORD dwExtraInfo // 32 бита определенной прикладной информации
);


Параметры

dwFlags

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

Значение Величины
MOUSEEVENTF_ABSOLUTE Определяет, что dx и dy параметры содержат нормализованные абсолютные координаты. Если не установлено, те параметры содержат относительные данные: изменение в позиции с тех пор как последний раз зарегистрированная позиция. Этот флаг может быть установлен, или не установленное, независимо от которого тип мыши или устройства наподобие мыши, если имеется в наличии, подключен к системе. Для дальнейшей информации об относительном движении мыши, смотри секцию Замечаний следующего.
MOUSEEVENTF_MOVE Определяет, что перемещение происходило.
MOUSEEVENTF_LEFTDOWN Определяет, что левая кнопка изменялась на вниз.
MOUSEEVENTF_LEFTUP Определяет, что левая кнопка изменяла, чтобы по.
MOUSEEVENTF_RIGHTDOWN Определяет, что кнопка права изменялась на вниз.
MOUSEEVENTF_RIGHTUP Определяет, что кнопка права изменяла, чтобы по.
MOUSEEVENTF_MIDDLEDOWN Определяет, что средняя кнопка изменялась на вниз.
MOUSEEVENTF_MIDDLEUP Определяет, что средняя кнопка изменяла, чтобы по.
MOUSEEVENTF_WHEEL Windows NT только: Определяет, что колесо перемещено, если мышь имеет колесо. Сумма перемещения дана в dwData


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

dx

Определяет абсолютной позиции мыши вдоль x-axis или суммы движения с тех пор как последнее событие мыши было сгенерировано, в зависимости от установки MOUSEEVENTF_ABSOLUTE. Абсолютные данные даны как мышь фактический x-coordinate; относительные данные даны как число mickeys перемещенное.

dy

Определяет абсолютной позиции мыши вдоль y-axis или суммы движения с тех пор как последнее событие мыши было сгенерировано, в зависимости от установки MOUSEEVENTF_ABSOLUTE. Абсолютные данные даны как мышь фактический y-coordinate; относительные данные даны как число mickeys перемещенное.

dwData

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

dwExtraInfo

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



Обратные Величины

Эта функция не имеет обратную величину.

Замечания

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

Если величина MOUSEEVENTF_ABSOLUTE не определена, dx и dy определять относительные движения из когда последнее событие мыши было сгенерировано ( последний раз зарегистрированная позиция). Положительные величины означают мышь переместившую право (или вниз); отрицательные величины означают мышь перемещенную оставленное (или по).
Относительное движение мыши подвергается эффектам скорости мыши и двух величины порога мыши. В Windows NT, конечный пользователь устанавливает эти три величины с Мышью, прослеживающей движок Скорости Панели Управления Мыши опции; в Windows 95, конечный пользователь устанавливает ему с движком Скорости Указателя Панели Управления Мыши свойства листа. Приложение получает и устанавливает эти величины с функцией SystemParametersInfo.

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

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

Смотри Также

GetMessageExtraInfo, SystemParametersInfo


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz