Udostępnij przez


Używanie zdarzeń myszy

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ń.

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 wywoływane.

Zdarzenie myszy Opis
Click To zdarzenie występuje, gdy przycisk myszy jest zwalniany, zazwyczaj przed zdarzeniem MouseUp. Obsługa 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ą. Obsługa 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. Obsługa tego zdarzenia otrzymuje argument typu EventArgs. Obsłuż to zdarzenie, gdy tylko musisz określić, kiedy występuje dwukrotne kliknięcie.
MouseDoubleClick To zdarzenie występuje, gdy użytkownik dwukrotnie kliknie kontrolkę myszą. Obsługa tego zdarzenia otrzymuje argument typu MouseEventArgs. Zajmij się tym zdarzeniem, 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. Obsługa 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. Obsługa tego zdarzenia otrzymuje argument typu EventArgs.
MouseHover To zdarzenie występuje, gdy wskaźnik myszy zatrzymuje się i spoczywa na kontrolce. Obsługa tego zdarzenia otrzymuje argument typu EventArgs.
MouseLeave To zdarzenie występuje, gdy wskaźnik myszy opuszcza obramowanie lub obszar roboczy kontrolki, zależnie od typu kontrolki. Obsługa tego zdarzenia otrzymuje argument typu EventArgs.
MouseMove To zdarzenie występuje, gdy wskaźnik myszy przesuwa się, gdy znajduje się on nad kontrolką. Obsługa tego zdarzenia otrzymuje argument typu MouseEventArgs.
MouseUp To zdarzenie występuje, gdy wskaźnik myszy jest nad kontrolką, a użytkownik zwalnia przycisk myszy. Obsługa tego zdarzenia otrzymuje argument typu MouseEventArgs.
MouseWheel To zdarzenie występuje, gdy użytkownik obraca koło myszy, gdy kontrolka ma fokus. Obsługa tego zdarzenia otrzymuje argument typu MouseEventArgs. Użyj właściwości , MouseEventArgs.Delta aby określić, jak daleko przewija się mysz.

Informacje o myszach

MouseEventArgs jest wysyłany do obsługujących zdarzenia związanych z kliknięciem przycisku i śledzeniem ruchu myszy. MouseEventArgs zawiera informacje o bieżącym stanie myszy, w tym lokalizację wskaźnika myszy we współrzędnych okna, naciśnięte przyciski myszy oraz to, czy kółko myszy zostało przewinięte. Kilka zdarzeń myszy, takich jak te, które zachodzą, gdy wskaźnik myszy wszedł lub opuścił granice kontrolki, wysyłają EventArgs do programu obsługi zdarzeń bez dalszych informacji.

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

Konwertowanie współrzędnych ekranu i klienta

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

Zachowanie standardowego zdarzenia 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 bit stylu StandardDoubleClick na wartość true. 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:

Renderowanie wyglądu kontrolek przełącznika

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

  1. Użytkownik naciska przycisk myszy.

  2. Kontrolka wyświetla się w stanie naciśniętym.

  3. Zdarzenie MouseDown jest zgłaszane.

  4. Użytkownik zwalnia przycisk myszy.

  5. Kontrolka jest wyświetlana w stanie podniesionym.

  6. Zdarzenie Click jest zgłaszane.

  7. Zdarzenie MouseClick jest zgłaszane.

  8. Zdarzenie MouseUp jest zgłaszane.

    Uwaga / Notatka

    Jeśli użytkownik przenosi wskaźnik z kontrolki przełącznika, gdy przycisk myszy jest przytrzymany (na przykład przesuwanie myszy z Button kontrolki, gdy jest naciśnięty), przełącznik kontrolki jest wizualnie przedstawiany w stanie podniesionym i występuje jedynie zdarzenie MouseUp. Zdarzenia Click lub MouseClick nie wystąpią w tej sytuacji.

Zobacz także