Partage via

MouseEventArgs Classe

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Fournit les données des événements MouseUp, MouseDown et 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
Héritage
Object
EventArgs
MouseEventArgs
Dérivé
Attributs
ComVisibleAttribute

Exemples

L’exemple de code suivant gère l’événement MouseDown sur un TextBox contrôle afin que le fait de cliquer sur le bouton droit de la souris sélectionne tout le texte du contrôle. Cet exemple nécessite que vous disposiez d’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.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

L’exemple de code suivant utilise la Location propriété pour suivre les clics du bouton gauche de la souris et dessiner une série de segments en ligne droite en réponse à une entrée utilisateur. L’exemple ne redessine pas les lignes si vous masquez le formulaire, puis le réexéquez ; 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 X propriétés et Y 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 alors 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 alors 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. Un MouseEventArgs spécifie le bouton de la souris appuyé, 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 déplacement de la roulette de la souris.

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

Ces trois événements existent pour les Controlclasses , AxHostet NotifyIcon .

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

Constructeurs

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

Initialise une nouvelle instance de la classe MouseEventArgs.

Propriétés

Button

Obtient le bouton de la souris sur lequel l'utilisateur a appuyé.
Clicks

Obtient le nombre de fois où l'utilisateur a cliqué sur le bouton de la souris et l'a relâché.
Delta

Obtient un décompte signé du nombre de détentes de rotation de la roulette de la souris, multiplié par la constante WHEEL_DELTA. Une détente représente un cran de la roulette de la souris.
Location

Obtient l'emplacement de la souris pendant la génération d'événement de souris.
X

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

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

Méthodes

Equals(Object)

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

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

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

(Hérité de Object)

S’applique à

Voir aussi