MouseEventArgs MouseEventArgs MouseEventArgs MouseEventArgs Class

Définition

Fournit les données des événements MouseUp, MouseDown et MouseMove.Provides data for the MouseUp, MouseDown, and MouseMove events.

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

Exemples

Les exemples de code suivants gèrent MouseDown l’événement sur TextBox un contrôle afin qu’un clic sur le bouton droit de la souris sélectionne tout le texte dans le contrôle.The following code examples handles the MouseDown event on a TextBox control so that clicking the right mouse button selects all the text in the control. Cet exemple nécessite que vous disposiez d’un formulaire qui TextBox contient un contrôle nommé textBox1.This example requires that you have a form that contains a TextBox control that is named 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 Location la propriété pour effectuer le suivi des clics du bouton gauche de la souris et pour dessiner une série de segments de ligne droite en réponse à une entrée utilisateur.The following code example uses the Location property to track clicks of the left mouse button and to draw a series of straight line segments in response to user input. L’exemple ne redessine pas les lignes si vous masquez le formulaire, puis le réaffichez. Ce code a été omis pour des raisons de simplicité.The example does not redraw the lines if you hide the form and then redisplay it; this code has been omitted for simplicity.

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 X les Y propriétés et pour afficher la position actuelle du pointeur de la souris ToolTip dans une fenêtre.The following code example uses the X and Y properties to display the current position of the mouse pointer in a ToolTip window.

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' MouseDown événement se produit lorsque l’utilisateur appuie sur le bouton de la souris alors que le pointeur est sur un contrôle.The MouseDown event occurs when the user presses the mouse button while the pointer is over a control. L' MouseUp événement se produit lorsque l’utilisateur relâche le bouton de la souris alors que le pointeur reste sur le contrôle.The MouseUp event occurs when the user releases the mouse button while the pointer remains over the control. L' MouseMove événement se produit lorsque l’utilisateur déplace le pointeur de la souris sur un contrôle.The MouseMove event occurs when the user moves the mouse pointer over a control. Un MouseEventArgs spécifie le bouton de la souris sur lequel l’utilisateur a appuyé, le nombre de fois que le bouton de la souris a été enfoncé et relâché, les coordonnées de la souris et la distance de déplacement de la roulette de la souris.A MouseEventArgs specifies which mouse button is pressed, how many times the mouse button was pressed and released, the coordinates of the mouse, and the amount the mouse wheel moved.

Il est possible de recevoir un MouseDown événement sans correspondant MouseUp, si l’utilisateur bascule le focus sur une autre application avant de relâcher le bouton de la souris.It is possible to receive a MouseDown event without a corresponding MouseUp, if the user switches focus to another application before releasing the mouse button.

Ces trois événements existent pour les Controlclasses AxHost, et NotifyIcon .These three events exist for the Control, AxHost, and NotifyIcon classes.

Pour plus d’informations sur le modèle d’événement, consultez gestion et déclenchement d’événements.For information about the event model, see Handling and Raising Events.

Constructeurs

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

Initialise une nouvelle instance de la classe MouseEventArgs.Initializes a new instance of the MouseEventArgs class.

Propriétés

Button Button Button Button

Obtient le bouton de la souris sur lequel l'utilisateur a appuyé.Gets which mouse button was pressed.

Clicks Clicks Clicks Clicks

Obtient le nombre de fois où l'utilisateur a cliqué sur le bouton de la souris et l'a relâché.Gets the number of times the mouse button was pressed and released.

Delta Delta Delta 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.Gets a signed count of the number of detents the mouse wheel has rotated, multiplied by the WHEEL_DELTA constant. Une détente représente un cran de la roulette de la souris.A detent is one notch of the mouse wheel.

Location Location Location Location

Obtient l'emplacement de la souris pendant la génération d'événement de souris.Gets the location of the mouse during the generating mouse event.

X X X X

Obtient la coordonnée x de la souris pendant la génération d'événement de souris.Gets the x-coordinate of the mouse during the generating mouse event.

Y Y Y Y

Obtient la coordonnée y de la souris pendant la génération d'événement de souris.Gets the y-coordinate of the mouse during the generating mouse event.

Méthodes

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

S’applique à

Voir aussi