Control.MouseCaptureChanged Ereignis

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Tritt auf, wenn das Steuerelement die Mausaufnahme 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 Output in Visual Studio, damit Sie sehen können, wann Ereignisse ausgelöst werden. Klicken Sie auf die Button folgende Ausgabe, und beachten Sie die folgende Ausgabe.

button1_MouseDown

button1_MouseUp

button1_MouseCaptureChanged

Klicken Sie nun auf die linke Maustaste auf dem Button Steuerelement, und halten Sie sie gedrückt. Während Sie noch 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 behandeln können. Je nach 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 zu einem anderen Programm, indem er ALT+TAB drückt.

• 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 einem Formular oder steuerelement oder das Ausführen eines Mausziehvorgangs umfassen. Wenn Sie feststellen müssen, wann ein Formular oder ein Steuerelement die Mausaufnahme für diese und zugehörige unerwartete Szenarien verliert, können Sie das MouseCaptureChanged Ereignis verwenden.