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

Definition

Tritt ein, wenn das Steuerelement die Mausaufzeichnung verliert.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 

Beispiele

Im folgenden Codebeispiel wird das MouseCaptureChanged -Ereignis für Button ein-Steuerelement veranschaulicht.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

Um dieses Beispiel zu testen, führen Sie es im Debugger aus, indem Sie F5 drücken.To test this example, run it in the debugger by pressing F5. Öffnen Sie das Ausgabe Fenster in Visual Studio, damit Sie sehen können, wann Ereignisse ausgelöst werden.Open the Output window in Visual Studio so that you can see when events are raised. Klicken Sie Button auf das, und beachten Sie die folgende Ausgabe.Click the Button and notice the following output.

button1_MouseDown

button1_MouseUp

button1_MouseCaptureChanged

Klicken Sie nun mit der linken Maustaste auf das Button Steuerelement.Now, click and hold the left mouse button on the Button control. Wenn Sie auf die Maus klicken, drücken Sie Alt + Tab, um zu einem anderen Programm zu wechseln.While still clicking the mouse, press ALT+TAB to switch to another program. Beachten Sie, MouseCaptureChanged dass das-Ereignis ausgelöst wird, sodass Sie dieses Szenario potenziell verarbeiten können.Notice that the MouseCaptureChanged event is raised enabling you to potentially handle this scenario. Abhängig von den Aktionen wird das MouseUp Ereignis möglicherweise nicht ausgelöst.Depending on your actions, the MouseUp event might not be raised. Sie können diesen Test auch mit der Windows-Taste oder STRG + ESC testen.You can also try this test with the Windows key or CTRL+ESC.

button1_MouseDown

button1_MouseCaptureChanged

Hinweise

In seltenen Szenarios müssen Sie möglicherweise unerwartete Eingaben erkennen.In rare scenarios, you might need to detect unexpected input. Beachten Sie z. b. die folgenden Szenarien:For example, consider the following scenarios.

  • Während einer Maus wird der Benutzer das Startmenü durch Drücken der Windows-Taste oder STRG + ESC geöffnet.During a mouse operation, the user opens the Start menu by pressing the Windows key or CTRL+ESC.

  • Während eines Mauszeigers wechselt der Benutzer durch Drücken von Alt + Tab zu einem anderen Programm.During a mouse operation, the user switches to another program by pressing ALT+TAB.

  • Während einer Maus Operation zeigt ein anderes Programm ein Fenster oder ein Meldungs Feld an, das den Fokus von der aktuellen Anwendung entfernt.During a mouse operation, another program displays a window or a message box that takes focus away from the current application.

Maus Vorgänge können das Klicken und halten der Maus auf ein Formular oder ein Steuerelement oder das Ausführen eines Maus Zieh Vorgangs einschließen.Mouse operations can include clicking and holding the mouse on a form or a control, or performing a mouse drag operation. Wenn Sie erkennen müssen, wenn ein Formular oder ein Steuerelement die Maus Aufzeichnung für diese und verwandte unerwartete Szenarien verliert, können Sie MouseCaptureChanged das-Ereignis verwenden.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.

Gilt für: