MouseEventArgs Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Предоставляет данные для событий MouseUp, MouseDown и MouseMove.

public ref class MouseEventArgs : EventArgs

public class MouseEventArgs : EventArgs

type MouseEventArgs = class
    inherit EventArgs

Public Class MouseEventArgs
Inherits EventArgs

Наследование

Object

EventArgs

MouseEventArgs

Производный

System.Windows.Forms.DataGridViewCellMouseEventArgs

System.Windows.Forms.HandledMouseEventArgs

System.Windows.Forms.StatusBarPanelClickEventArgs

System.Windows.Forms.TreeNodeMouseClickEventArgs

Примеры

В следующем примере кода событие в элементе MouseDownTextBox управления обрабатывается таким образом, что при нажатии правой кнопки мыши выделяется весь текст в элементе управления . В этом примере требуется форма, содержащая TextBox элемент управления с именем textBox1.

private void Form1_Load(object sender, EventArgs e)
{
    // This line suppresses the default context menu for the TextBox control. 
    textBox1.ContextMenu = new ContextMenu();
    textBox1.MouseDown += new MouseEventHandler(textBox1_MouseDown);
}

void textBox1_MouseDown(object sender, System.Windows.Forms.MouseEventArgs e)
{
    if (e.Button == MouseButtons.Right)
    {
        textBox1.Select(0, textBox1.Text.Length);
    }
}

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
    TextBox1.ContextMenu = New ContextMenu()
End Sub

Private Sub TextBox1_MouseDown(ByVal sender As Object, ByVal e As System.Windows.Forms.MouseEventArgs) Handles TextBox1.MouseDown
    If (e.Button = Windows.Forms.MouseButtons.Right) Then
        TextBox1.Select(0, TextBox1.Text.Length)
    End If
End Sub

В следующем примере кода свойство используется Location для отслеживания щелчков левой кнопки мыши и рисования ряда сегментов прямой линии в ответ на ввод пользователя. В примере строки не перерисовываются, если вы скрываете форму и затем перерисовываете ее; Этот код был опущен для простоты.

Point firstPoint;
Boolean haveFirstPoint;

public void EnableDrawing()
{
    this.MouseDown += new MouseEventHandler(Form1_MouseDownDrawing);
}

void Form1_MouseDownDrawing(object sender, System.Windows.Forms.MouseEventArgs e)
{
    if (haveFirstPoint)
    {
        Graphics g = this.CreateGraphics();
        g.DrawLine(Pens.Black, firstPoint, e.Location);
        haveFirstPoint = false;
    }
    else
    {
        firstPoint = e.Location;
        haveFirstPoint = true;
    }
}

Dim FirstPoint As Point
Dim HaveFirstPoint As Boolean = False

Private Sub Form1_MouseDownDrawing(ByVal sender As Object, ByVal e As System.Windows.Forms.MouseEventArgs) Handles Me.MouseDown
    If HaveFirstPoint Then
        Dim g As Graphics = Me.CreateGraphics()
        g.DrawLine(Pens.Black, FirstPoint, e.Location)
        HaveFirstPoint = False
    Else
        FirstPoint = e.Location
        HaveFirstPoint = True
    End If
End Sub

В следующем примере кода свойства и Y используются X для отображения текущего положения указателя мыши в ToolTip окне.

ToolTip trackTip;

private void TrackCoordinates()
{
    trackTip = new ToolTip();
    this.MouseMove += new MouseEventHandler(Form1_MouseMove);
}

void Form1_MouseMove(object sender, System.Windows.Forms.MouseEventArgs e)
{
    String tipText = String.Format("({0}, {1})", e.X, e.Y);
    trackTip.Show(tipText, this, e.Location);
}

Dim TrackTip As ToolTip

Private Sub TrackCoordinates()
    TrackTip = New ToolTip()
End Sub

Private Sub Form1_MouseMove(ByVal sender As Object, ByVal e As System.Windows.Forms.MouseEventArgs) Handles Me.MouseMove
    Dim TipText As String = String.Format("({0}, {1})", e.X, e.Y)
    TrackTip.Show(TipText, Me, e.Location)
End Sub

Комментарии

Это MouseDown событие возникает, когда пользователь нажимает кнопку мыши, когда указатель находится на элементе управления. Это MouseUp событие возникает, когда пользователь отпускает кнопку мыши, пока указатель остается на элементе управления. Это MouseMove событие возникает, когда пользователь перемещает указатель мыши на элемент управления. Определяет MouseEventArgs , какая кнопка мыши нажата, сколько раз она нажималась и отпускалась, координаты мыши и количество перемещений колесика мыши.

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

Эти три события существуют для Controlклассов , AxHostи NotifyIcon .

Сведения о модели событий см. в разделе Обработка и вызов событий.

Конструкторы

MouseEventArgs(MouseButtons, Int32, Int32, Int32, Int32)

Инициализирует новый экземпляр класса MouseEventArgs.

Свойства

Button	Возвращает значение, указывающее, какая кнопка мыши была нажата.
Clicks	Возвращает значение, указывающее, сколько раз была нажата и отпущена кнопка мыши.
Delta	Получает значение со знаком, указывающее количество делений, на которое повернулось колесико мыши, умноженное на константу WHEEL_DELTA. Делением называется один зубец колесика мыши.
Location	Возвращает расположение указателя мыши в момент создания события мыши.
X	Возвращает координату X указателя мыши в момент создания события мыши.
Y	Возвращает координату Y указателя мыши в момент создания события мыши.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• OnMouseDown(MouseEventArgs)
• MouseDown
• OnMouseUp(MouseEventArgs)
• MouseUp
• OnMouseMove(MouseEventArgs)
• MouseMove
• MouseDown
• MouseUp
• MouseMove