Событие MouseUp

Имеет место, когда пользователь отпускает кнопку мыши.

Применение:
CheckBox, ComboBox, CommandButton, CommandGroup, Объект Container, Объект Control, EditBox, Form, Grid, Header, Image, Label, Line, ListBox, OptionButton, OptionGroup, Page, PageFrame, Shape, Spinner, TextBox, ToolBar.

Синтаксис:

PROCEDURE Object.MouseUp
[LPARAMETERS nButton, nShift, nXCoord, nYCoord]
 -Или-
LPARAMETERS nIndex, nButton, nShift, nXCoord, nYCoord

Параметры:
Вы должны включить в процедуру события оператор LPARAMETERS или PARAMETERS и задать имя для каждого параметра. Visual FoxPro передает событию MouseUp четыре или пять параметров в следующем порядке.
nIndex
Содержит номер, однозначно идентифицирующий элемент управления, если он принадлежит массиву элементов управления.
nButton
Содержит число, задающее кнопку, при отпускании которой произошло данное событие: 1 (левая), 2 (правая) или 4 (средняя).
Параметр nButton представляет собой сумму трех битов, соответствующих левой кнопке мыши (бит 0), правой кнопке мыши (бит 1) и средней кнопке мыши (бит 2) значения 1, 2 и 4. Может быть установлен только один из этих битов, и он укажет на то, какая именно кнопка была отпущена, вызвав данное событие.
nShift
Содержит число, определяющее состояние клавиш SHIFT, CTRL и ALT, когда отпускается кнопка, заданная параметром nButton: 1 (SHIFT), 2 (CTRL), 4 (ALT).
Если какая-либо из этих клавиш была нажата, устанавливается соответствующий бит. Аргумент nShift представляет собой сумму этих битов, и в нем наименее значащие биты представляют клавиши SHIFT (бит 0), CTRL (бит 1) и ALT (бит 2). Эти биты соответствуют значениям 1, 2 и 4. Параметр nShift характеризует состояние данных клавиш. Могут быть установлены некоторые из битов, все биты или ни один из них; это говорит о том, что нажаты некоторые из клавиш, все три или ни одна. Например, если были нажаты клавиши CTRL и ALT, значение параметра nShift равно 6.
nXCoord, nYCoord
Содержит текущее значение горизонтальной (nXCoord) и вертикальной (nYCoord) позиции указателя мыши в пределах объекта Form. Эти координаты всегда выражаются относительно заданной системы координат объекта Form, с использованием единицы измерения, определенной установкой свойства ScaleMode.

Комментарии:
Используя свойство MouseUp, можно задавать действия, которые будут происходить при отпускании данной кнопки мыши. В отличие от событийClick и DblClick, событие MouseUp позволяет различать левую, правую и среднюю кнопки мыши. Вы также можете написать код для комбинированных действий мыши и клавиатуры, использующих клавиши-модификаторы SHIFT, CTRL и ALT.
Чтобы реагировать на событие, вызываемое перемещением мыши, можно использовать процедуру события MouseMove.
Замечание. Аргумент nButton для событий MouseDown и MouseUp отличается от аргумента nButton, используемого в процедуре события MouseMove. В случае MouseDown или MouseUp аргумент nButton указывает ровно одну кнопку для каждого события, в случае MouseMove он указывает текущее состояние всех кнопок.


Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем.