Событие 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 он указ вает текущее состояние всех кнопок.