Używanie zdarzeń myszy (Windows Forms .NET)

Większość programów Windows Forms przetwarza wprowadzanie myszy przez obsługę zdarzeń myszy. Ten artykuł zawiera omówienie zdarzeń myszy, w tym szczegółowe informacje na temat tego, kiedy należy używać każdego zdarzenia i danych dostarczonych dla każdego zdarzenia. Aby uzyskać więcej informacji o zdarzeniach ogólnych, zobacz Omówienie zdarzeń (Windows Forms .NET).

Ważne

Dokumentacja przewodnika dla komputerów dla platform .NET 7 i .NET 6 jest w budowie.

Zdarzenia myszy

Podstawowym sposobem reagowania na dane wejściowe myszy jest obsługa zdarzeń myszy. W poniższej tabeli przedstawiono zdarzenia myszy i opisano, kiedy są one podniesione.

Zdarzenie myszy opis
Click To zdarzenie występuje, gdy przycisk myszy jest zwalniany, zazwyczaj przed zdarzeniem MouseUp . Procedura obsługi dla tego zdarzenia otrzymuje argument typu EventArgs. Obsłuż to zdarzenie, gdy musisz określić tylko, kiedy nastąpi kliknięcie.
MouseClick To zdarzenie występuje, gdy użytkownik kliknie kontrolkę myszą. Procedura obsługi dla tego zdarzenia otrzymuje argument typu MouseEventArgs. Obsłuż to zdarzenie, gdy musisz uzyskać informacje o myszy po kliknięciu.
DoubleClick To zdarzenie występuje po dwukrotnym kliknięciu kontrolki. Procedura obsługi dla tego zdarzenia otrzymuje argument typu EventArgs. Obsłuż to zdarzenie, gdy musisz określić, kiedy występuje dwukrotne kliknięcie.
MouseDoubleClick To zdarzenie występuje, gdy użytkownik dwukrotnie kliknie kontrolkę myszą. Procedura obsługi dla tego zdarzenia otrzymuje argument typu MouseEventArgs. Obsłuż to zdarzenie, gdy musisz uzyskać informacje o myszy po dwukrotnym kliknięciu.
MouseDown To zdarzenie występuje, gdy wskaźnik myszy jest nad kontrolką, a użytkownik naciska przycisk myszy. Procedura obsługi dla tego zdarzenia otrzymuje argument typu MouseEventArgs.
MouseEnter To zdarzenie występuje, gdy wskaźnik myszy przechodzi do obramowania lub obszaru klienta kontrolki, w zależności od typu kontrolki. Procedura obsługi dla tego zdarzenia otrzymuje argument typu EventArgs.
MouseHover To zdarzenie występuje, gdy wskaźnik myszy zatrzymuje się i spoczywa na kontrolce. Procedura obsługi dla tego zdarzenia otrzymuje argument typu EventArgs.
MouseLeave To zdarzenie występuje, gdy wskaźnik myszy opuszcza obramowanie lub obszar klienta kontrolki, w zależności od typu kontrolki. Procedura obsługi dla tego zdarzenia otrzymuje argument typu EventArgs.
MouseMove To zdarzenie występuje, gdy wskaźnik myszy przesuwa się, gdy znajduje się on nad kontrolką. Procedura obsługi dla tego zdarzenia otrzymuje argument typu MouseEventArgs.
MouseUp To zdarzenie występuje, gdy wskaźnik myszy jest nad kontrolką, a użytkownik zwalnia przycisk myszy. Procedura obsługi dla tego zdarzenia otrzymuje argument typu MouseEventArgs.
MouseWheel To zdarzenie występuje, gdy użytkownik obraca koło myszy, gdy kontrolka ma fokus. Procedura obsługi dla tego zdarzenia otrzymuje argument typu MouseEventArgs. Możesz użyć Delta właściwości , MouseEventArgs aby określić, jak daleko mysz przewijała.

Informacje o myszach

Element jest MouseEventArgs wysyłany do procedur obsługi zdarzeń myszy związanych z kliknięciem przycisku myszy i śledzeniem ruchów myszy. MouseEventArgs Zawiera informacje o bieżącym stanie myszy, w tym o lokalizacji wskaźnika myszy we współrzędnych klienta, które przyciski myszy są naciskane i czy kółko myszy przewijane. Kilka zdarzeń myszy, takich jak te, które są podniesione, gdy wskaźnik myszy został wprowadzony lub pozostawiony granice kontrolki, wyślij element do EventArgs programu obsługi zdarzeń bez dalszych informacji.

Jeśli chcesz znać bieżący stan przycisków myszy lub lokalizację wskaźnika myszy i chcesz uniknąć obsługi zdarzenia myszy, możesz również użyć MouseButtons właściwości Control i MousePosition klasy . MouseButtons Zwraca informacje o tym, które przyciski myszy są obecnie naciskane. Funkcja MousePosition zwraca współrzędne ekranu wskaźnika myszy i jest równoważna wartości zwracanej przez Positionelement .

Konwertowanie współrzędnych ekranu i klienta

Ponieważ niektóre informacje o lokalizacji myszy są we współrzędnych klienta, a niektóre są współrzędne ekranu, może być konieczne przekonwertowanie punktu z jednego układu współrzędnych na drugi. Można to łatwo zrobić przy użyciu PointToClient metod i PointToScreen dostępnych w Control klasie .

Zachowanie zdarzenia standardowego kliknięcia

Jeśli chcesz obsługiwać zdarzenia kliknięcia myszy w odpowiedniej kolejności, musisz znać kolejność, w jakiej zdarzenia kliknięć są wywoływane w kontrolkach Windows Forms. Wszystkie kontrolki Windows Forms zgłaszają zdarzenia kliknięcia w tej samej kolejności, gdy dowolny obsługiwany przycisk myszy jest naciśnięty i zwalniany, z wyjątkiem sytuacji, w których zaznaczono na poniższej liście poszczególnych kontrolek. Na poniższej liście przedstawiono kolejność zdarzeń zgłoszonych dla jednego kliknięcia przycisku myszy:

  1. MouseDown Zdarzenie.
  2. Click Zdarzenie.
  3. MouseClick Zdarzenie.
  4. MouseUp Zdarzenie.

Poniżej przedstawiono kolejność zdarzeń wywoływanych dla dwukrotnego kliknięcia przycisku myszy:

  1. MouseDown Zdarzenie.

  2. Click Zdarzenie.

  3. MouseClick Zdarzenie.

  4. MouseUp Zdarzenie.

  5. MouseDown Zdarzenie.

  6. DoubleClick Zdarzenie.

    Może się to różnić w zależności od tego, czy w danej kontrolce ustawiono StandardDoubleClick bit stylu na truewartość . Aby uzyskać więcej informacji na temat ustawiania bitów, zobacz metodę ControlStylesSetStyle .

  7. MouseDoubleClick Zdarzenie.

  8. MouseUp Zdarzenie.

Poszczególne kontrolki

Następujące kontrolki nie są zgodne ze standardowym zachowaniem zdarzenia kliknięcia myszy:

Malowanie zachowania kontrolek przełącznika

Przełącz kontrolki, takie jak kontrolki pochodzące z klasy, mają następujące charakterystyczne zachowanie malowania w połączeniu ButtonBase ze zdarzeniami kliknięcia myszy:

  1. Użytkownik naciska przycisk myszy.

  2. Kontrolka maluje się w stanie naciśniętym.

  3. Zdarzenie MouseDown jest zgłaszane.

  4. Użytkownik zwalnia przycisk myszy.

  5. Kontrolka maluje w stanie podniesionym.

  6. Zdarzenie Click jest zgłaszane.

  7. Zdarzenie MouseClick jest zgłaszane.

  8. Zdarzenie MouseUp jest zgłaszane.

    Uwaga

    Jeśli użytkownik przenosi wskaźnik z kontrolki przełącznika, gdy przycisk myszy jest wyłączony (na przykład przesuwając mysz poza Button kontrolkę, gdy jest naciśnięty), kontrolka przełącznika będzie malować w stanie podniesionym i występuje tylko MouseUp zdarzenie. Zdarzenia Click lub MouseClick nie wystąpią w tej sytuacji.

Zobacz też