Control.MouseCaptureChanged Événement

Définition

Se produit quand le contrôle perd la capture de la souris.

public:
 event EventHandler ^ MouseCaptureChanged;
public event EventHandler MouseCaptureChanged;
public event EventHandler? MouseCaptureChanged;
member this.MouseCaptureChanged : EventHandler 
Public Custom Event MouseCaptureChanged As EventHandler 

Type d'événement

Exemples

L’exemple de code suivant illustre l’événement MouseCaptureChanged d’un Button contrôle.

private void button1_MouseDown(object sender, MouseEventArgs e)
{
    System.Diagnostics.Debug.WriteLine("button1_MouseDown");
}

private void button1_MouseUp(object sender, MouseEventArgs e)
{
    System.Diagnostics.Debug.WriteLine("button1_MouseUp");
}

private void button1_MouseCaptureChanged(object sender, EventArgs e)
{
    System.Diagnostics.Debug.WriteLine("button1_MouseCaptureChanged");
}
Private Sub Button1_MouseDown(ByVal sender As System.Object, _
ByVal e As MouseEventArgs) Handles Button1.MouseDown
    Debug.WriteLine("Button1_MouseDown")
End Sub

Private Sub Button1_MouseUp(ByVal sender As System.Object, _
ByVal e As MouseEventArgs) Handles Button1.MouseUp
    Debug.WriteLine("Button1_MouseUp")
End Sub

Private Sub Button1_MouseCaptureChanged(ByVal sender As System.Object, _
ByVal e As EventArgs) Handles Button1.MouseCaptureChanged
    Debug.WriteLine("Button1_MouseCaptureChanged")
End Sub

Pour tester cet exemple, exécutez-le dans le débogueur en appuyant sur F5. Ouvrez la fenêtre Sortie dans Visual Studio afin de voir quand des événements sont déclenchés. Cliquez sur et Button notez la sortie suivante.

button1_MouseDown

button1_MouseUp

button1_MouseCaptureChanged

Maintenant, cliquez et maintenez le bouton gauche de la souris sur le Button contrôle. Tout en cliquant sur la souris, appuyez sur ALT+TAB pour basculer vers un autre programme. Notez que l’événement MouseCaptureChanged est déclenché, ce qui vous permet de gérer potentiellement ce scénario. En fonction de vos actions, l’événement MouseUp peut ne pas être déclenché. Vous pouvez également essayer ce test avec la touche Windows ou CTRL+ÉCHAP.

button1_MouseDown

button1_MouseCaptureChanged

Remarques

Dans de rares scénarios, vous devrez peut-être détecter une entrée inattendue. Par exemple, considérez les scénarios suivants.

  • Pendant une opération à la souris, l’utilisateur ouvre le menu Démarrer en appuyant sur la touche Windows ou ctrl+Échap.

  • Pendant une opération de souris, l’utilisateur bascule vers un autre programme en appuyant sur ALT+TAB.

  • Pendant une opération de souris, un autre programme affiche une fenêtre ou une boîte de message qui éloigne le focus de l’application actuelle.

Les opérations de souris peuvent inclure le fait de cliquer et de maintenir la souris sur un formulaire ou un contrôle, ou d’effectuer une opération de glissement de la souris. Si vous devez détecter quand un formulaire ou un contrôle perd la capture de la souris pour ces scénarios inattendus et associés, vous pouvez utiliser l’événement MouseCaptureChanged .

S’applique à