Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source

MouseEventArgs, classe

Fournit les données des événements MouseUp, MouseDown et MouseMove.

Espace de noms :  System.Windows.Forms
Assembly :  System.Windows.Forms (dans System.Windows.Forms.dll)

[ComVisibleAttribute(true)]
public class MouseEventArgs : EventArgs

Le type MouseEventArgs expose les membres suivants.

  NomDescription
Méthode publiqueMouseEventArgsInitialise une nouvelle instance de la classe MouseEventArgs.
Début

  NomDescription
Propriété publiqueButtonObtient le bouton de la souris sur lequel l'utilisateur a appuyé.
Propriété publiqueClicksObtient le nombre de fois où l'utilisateur a cliqué sur le bouton de la souris et l'a relâché.
Propriété publiqueDeltaObtient 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.
Propriété publiqueLocationObtient l'emplacement de la souris pendant la génération d'événement de souris.
Propriété publiqueXObtient la coordonnée x de la souris pendant la génération d'événement de souris.
Propriété publiqueYObtient la coordonnée y de la souris pendant la génération d'événement de souris.
Début

  NomDescription
Méthode publiqueEquals(Object)Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueGetHashCodeSert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Début

L'événement MouseDown se produit lorsque l'utilisateur appuie sur le bouton de la souris lorsque le pointeur se trouve sur un contrôle. L'événement MouseUp se produit lorsque l'utilisateur relâche le bouton de la souris lorsque 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. MouseEventArgs spécifie le bouton de la souris sur lequel l'utilisateur a cliqué, le nombre de fois que l'utilisateur a enfoncé puis relâché le bouton, les coordonnées de la souris et le déplacement de la roulette de la souris.

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

Ces trois événements existent pour les classes Control, AxHost et NotifyIcon.

Pour plus d'informations sur le modèle d'événement, consultez Événements et délégués.

Les exemples de code suivants gèrent l'événement MouseDown sur un contrôle TextBox afin qu'un clic avec le bouton droit de la souris sélectionne la totalité du texte dans le contrôle. Cet exemple suppose que vous disposez d'un formulaire contenant un contrôle TextBox 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);
    }
}


L'exemple de code suivant utilise la propriété Location pour effectuer le suivi des clics avec le bouton gauche de la souris et dessiner une série de segments de ligne droite en réponse à l'entrée d'utilisateur. L'exemple ne redessine pas les lignes si vous masquez le formulaire et le réaffichez ensuite ; pour simplifier, ce code a été omis.


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;
    }
}


L'exemple de code suivant utilise les propriétés X et Y pour afficher la position actuelle du pointeur de souris dans une fenêtre 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);
}


.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft