MouseEventArgs Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- Dérivé
- Attributs
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) |