MouseEventArgs Classe

Définition

Fournit des données pour les événements et MouseUp les MouseDownMouseMoveévénements.

public ref class MouseEventArgs : EventArgs
[System.Runtime.InteropServices.ComVisible(true)]
public class MouseEventArgs : EventArgs
[<System.Runtime.InteropServices.ComVisible(true)>]
type MouseEventArgs = class
    inherit EventArgs
Public Class MouseEventArgs
Inherits EventArgs
Héritage
MouseEventArgs
Dérivé
Attributs

Exemples

L’exemple de code suivant gère l’événement MouseDown sur un TextBox contrôle afin que le clic sur le bouton droit de la souris sélectionne tout le texte du contrôle. Cet exemple nécessite que vous ayez un formulaire qui contient un TextBox contrôle nommé 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.ContextMenuStrip = New ContextMenuStrip()
End Sub

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

L’exemple de code suivant utilise la Location propriété pour suivre les clics du bouton de la souris gauche et dessiner une série de segments de ligne droite en réponse à l’entrée utilisateur. L’exemple ne redessine pas les lignes si vous masquez le formulaire, puis redisplayez-le ; ce code a été omis par souci de simplicité.

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

L’exemple de code suivant utilise les propriétés et Y les X propriétés pour afficher la position actuelle du pointeur de la souris dans une ToolTip fenêtre.

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

Remarques

L’événement MouseDown se produit lorsque l’utilisateur appuie sur le bouton de la souris pendant que le pointeur se trouve sur un contrôle. L’événement MouseUp se produit lorsque l’utilisateur relâche le bouton de la souris pendant que le pointeur reste sur le contrôle. L’événement MouseMove se produit lorsque l’utilisateur déplace le pointeur de la souris sur un contrôle. Spécifie MouseEventArgs le bouton de la souris enfoncé, le nombre de fois où le bouton de la souris a été enfoncé et relâché, les coordonnées de la souris et la quantité de la roulette de la souris déplacée.

Il est possible de recevoir un MouseDown événement sans correspondant MouseUp, si l’utilisateur bascule le focus sur une autre application avant de libérer le bouton de la souris.

Ces trois événements existent pour les classes et AxHostNotifyIcon les Controlclasses.

Pour plus d’informations sur le modèle d’événement, consultez Gestion et déclenchement d’événements.

Constructeurs

Nom Description
MouseEventArgs(MouseButtons, Int32, Int32, Int32, Int32)

Initialise une nouvelle instance de la classe MouseEventArgs.

Propriétés

Nom Description
Button

Obtient le bouton de la souris qui a été appuyé.

Clicks

Obtient le nombre de fois où le bouton de la souris a été enfoncé et relâché.

Delta

Obtient un nombre signé du nombre de détents que la roulette de la souris a pivoté, multiplié par la constante WHEEL_DELTA. Un detent est un notch de la roulette de la souris.

Location

Obtient l’emplacement de la souris pendant l’événement de génération de la souris.

X

Obtient la coordonnée x de la souris pendant l’événement de génération de la souris.

Y

Obtient la coordonnée y de la souris pendant l’événement de génération de la souris.

Méthodes

Nom Description
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

S’applique à

Voir aussi