MouseEventArgs Класс

Определение

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

public ref class MouseEventArgs : EventArgs
[System.Runtime.InteropServices.ComVisible(true)]
public class MouseEventArgs : EventArgs
public class MouseEventArgs : EventArgs
[<System.Runtime.InteropServices.ComVisible(true)>]
type MouseEventArgs = class
    inherit EventArgs
type MouseEventArgs = class
    inherit EventArgs
Public Class MouseEventArgs
Inherits EventArgs
Наследование
MouseEventArgs
Производный
Атрибуты

Примеры

В следующем примере кода событие обрабатывается MouseDown в TextBox элементе управления, чтобы при нажатии правой кнопки мыши был выделен весь текст в элементе управления. В этом примере требуется форма, содержащая 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

В следующем примере кода используются X свойства и Y свойства для отображения текущей позиции указателя мыши в 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классов и AxHostNotifyIcon классов.

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

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

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)

Применяется к

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