Control.MouseCaptureChanged Ereignis

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Tritt ein, wenn das Steuerelement die Mausaufzeichnung verliert.

public:
 event EventHandler ^ MouseCaptureChanged;

public event EventHandler? MouseCaptureChanged;

member this.MouseCaptureChanged : EventHandler 

Public Custom Event MouseCaptureChanged As EventHandler 

Ereignistyp

EventHandler

Beispiele

Im folgenden Codebeispiel wird das MouseCaptureChanged -Ereignis für ein Button -Steuerelement veranschaulicht.

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. Öffnen Sie das Fenster Ausgabe in Visual Studio, damit Sie sehen können, wann Ereignisse ausgelöst werden. Klicken Sie auf , Button und sehen Sie die folgende Ausgabe.

button1_MouseDown

button1_MouseUp

button1_MouseCaptureChanged

Klicken Sie nun auf das Steuerelement, und halten Sie die Button linke Maustaste gedrückt. Während Sie weiterhin mit der Maus klicken, drücken Sie ALT+TAB, um zu einem anderen Programm zu wechseln. Beachten Sie, dass das MouseCaptureChanged Ereignis ausgelöst wird, sodass Sie dieses Szenario möglicherweise verarbeiten können. Abhängig von Ihren Aktionen wird das MouseUp Ereignis möglicherweise nicht ausgelöst. Sie können diesen Test auch mit der Windows-Taste oder STRG+ESC ausprobieren.

button1_MouseDown

button1_MouseCaptureChanged

Hinweise

In seltenen Szenarien müssen Sie möglicherweise unerwartete Eingaben erkennen. Betrachten Sie beispielsweise die folgenden Szenarien.

• Während eines Mausvorgangs öffnet der Benutzer das Startmenü, indem er die Windows-TASTE oder STRG+ESC drückt.

• Während eines Mausvorgangs wechselt der Benutzer durch Drücken von ALT+TAB zu einem anderen Programm.

• Während eines Mausvorgangs zeigt ein anderes Programm ein Fenster oder ein Meldungsfeld an, das den Fokus von der aktuellen Anwendung entfernt.

Mausvorgänge können das Klicken und Halten der Maus auf ein Formular oder ein Steuerelement oder das Ausführen eines Mausziehvorgangs umfassen. Wenn Sie erkennen müssen, wann ein Formular oder ein Steuerelement die Mausaufnahme für diese und verwandte unerwartete Szenarien verliert, können Sie das MouseCaptureChanged -Ereignis verwenden.