Control.MouseCaptureChanged Zdarzenie

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Występuje, gdy kontrolka traci przechwytywanie myszy.

public:
 event EventHandler ^ MouseCaptureChanged;

public event EventHandler? MouseCaptureChanged;

member this.MouseCaptureChanged : EventHandler 

Public Custom Event MouseCaptureChanged As EventHandler 

Typ zdarzenia

EventHandler

Przykłady

Poniższy przykład kodu przedstawia MouseCaptureChanged zdarzenie dla kontrolki Button .

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

Aby przetestować ten przykład, uruchom go w debugerze, naciskając klawisz F5. Otwórz okno Dane wyjściowe w programie Visual Studio, aby zobaczyć, kiedy są zgłaszane zdarzenia. Kliknij element Button i zwróć uwagę na następujące dane wyjściowe.

button1_MouseDown

button1_MouseUp

button1_MouseCaptureChanged

Teraz kliknij i przytrzymaj lewy przycisk myszy na kontrolce Button . Podczas klikania myszy naciśnij klawisze ALT+TAB, aby przełączyć się do innego programu. Zwróć uwagę, że MouseCaptureChanged zdarzenie jest wywoływane, umożliwiając potencjalnie obsługę tego scenariusza. W zależności od akcji MouseUp zdarzenie może nie zostać podniesione. Możesz również wypróbować ten test za pomocą klawisza systemu Windows lub klawisza CTRL+ESC.

button1_MouseDown

button1_MouseCaptureChanged

Uwagi

W rzadkich scenariuszach może być konieczne wykrycie nieoczekiwanych danych wejściowych. Rozważmy na przykład następujące scenariusze.

• Podczas operacji myszy użytkownik otwiera menu Start, naciskając klawisz Windows lub CTRL+ESC.

• Podczas operacji myszy użytkownik przełącza się do innego programu, naciskając klawisze ALT+TAB.

• Podczas operacji myszy inny program wyświetla okno lub pole komunikatu, które zabiera fokus od bieżącej aplikacji.

Operacje myszy mogą obejmować klikanie i trzymanie myszy na formularzu lub kontrolce lub wykonywanie operacji przeciągania myszy. Jeśli musisz wykryć, kiedy formularz lub kontrolka utraci przechwytywanie myszy dla tych i powiązanych nieoczekiwanych scenariuszy, możesz użyć MouseCaptureChanged zdarzenia.