Control.MouseCaptureChanged Control.MouseCaptureChanged Control.MouseCaptureChanged Control.MouseCaptureChanged Event

Définition

Se produit quand le contrôle perd la capture de la souris.Occurs when the control loses mouse capture.

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

Exemples

L’exemple de code suivant illustre MouseCaptureChanged l’événement pour Button un contrôle.The following code example demonstrates the MouseCaptureChanged event for a Button control.

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.To test this example, run it in the debugger by pressing F5. Ouvrez la fenêtre sortie dans Visual Studio afin de voir à quel moment les événements sont déclenchés.Open the Output window in Visual Studio so that you can see when events are raised. Cliquez sur Button et notez la sortie suivante.Click the Button and notice the following output.

button1_MouseDown

button1_MouseUp

button1_MouseCaptureChanged

Maintenant, cliquez et maintenez enfoncé le bouton gauche de la Button souris sur le contrôle.Now, click and hold the left mouse button on the Button control. Tout en continuant à cliquer sur la souris, appuyez sur ALT + TAB pour basculer vers un autre programme.While still clicking the mouse, press ALT+TAB to switch to another program. Notez que l' MouseCaptureChanged événement est déclenché, ce qui vous permet de gérer potentiellement ce scénario.Notice that the MouseCaptureChanged event is raised enabling you to potentially handle this scenario. Selon vos actions, l' MouseUp événement peut ne pas être déclenché.Depending on your actions, the MouseUp event might not be raised. Vous pouvez également essayer ce test avec la touche Windows ou CTRL + ESC.You can also try this test with the Windows key or CTRL+ESC.

button1_MouseDown

button1_MouseCaptureChanged

Remarques

Dans de rares scénarios, vous devrez peut-être détecter une entrée inattendue.In rare scenarios, you might need to detect unexpected input. Par exemple, considérez les scénarios suivants.For example, consider the following scenarios.

  • Pendant une opération de souris, l’utilisateur ouvre le menu démarrer en appuyant sur la touche Windows ou en appuyant sur CTRL + ÉCHAP.During a mouse operation, the user opens the Start menu by pressing the Windows key or CTRL+ESC.

  • Pendant une opération de souris, l’utilisateur bascule vers un autre programme en appuyant sur ALT + TAB.During a mouse operation, the user switches to another program by pressing ALT+TAB.

  • Pendant une opération de souris, un autre programme affiche une fenêtre ou une boîte de message qui s’occupe du focus de l’application actuelle.During a mouse operation, another program displays a window or a message box that takes focus away from the current application.

Les opérations de la souris peuvent inclure le clic et le maintien de la souris sur un formulaire ou un contrôle, ou l’exécution d’une opération glisser de la souris.Mouse operations can include clicking and holding the mouse on a form or a control, or performing a mouse drag operation. Si vous devez détecter le moment où un formulaire ou un contrôle perd la capture de la souris pour ces scénarios et les scénarios inattendus, vous pouvez utiliser l' MouseCaptureChanged événement.If you have to detect when a form or a control loses mouse capture for these and related unexpected scenarios, you can use the MouseCaptureChanged event.

S’applique à