Použití událostí myši (model Windows Forms .NET)

  • Článek

Většina model Windows Forms programů zpracovává vstup myši zpracováním událostí myši. Tento článek obsahuje přehled událostí myši, včetně podrobností o tom, kdy použít každou událost a data zadaná pro každou událost. Další informace o událostech obecně naleznete v tématu Přehled událostí (model Windows Forms .NET).

Důležité

Dokumentace k desktopové příručce pro .NET 7 a .NET 6 se právě připravuje.

Události myši

Primárním způsobem reakce na vstup myši je zpracování událostí myši. Následující tabulka ukazuje události myši a popisuje, kdy jsou vyvolány.

Událost myši Popis
Click K této události dochází při uvolnění tlačítka myši, obvykle před událostí MouseUp . Obslužná rutina pro tuto událost obdrží argument typu EventArgs. Tuto událost zpracujte pouze v případě, že potřebujete určit, kdy dojde k kliknutí.
MouseClick K této události dochází, když uživatel klikne na ovládací prvek myší. Obslužná rutina pro tuto událost obdrží argument typu MouseEventArgs. Tuto událost zpracujte, když potřebujete získat informace o myši, když dojde k kliknutí.
DoubleClick K této události dochází, když je ovládací prvek poklikáním. Obslužná rutina pro tuto událost obdrží argument typu EventArgs. Tuto událost zpracujte, jen když potřebujete určit, kdy dojde k dvojitému kliknutí.
MouseDoubleClick K této události dochází, když uživatel dvakrát klikne na ovládací prvek myší. Obslužná rutina pro tuto událost obdrží argument typu MouseEventArgs. Tuto událost zpracujte, když potřebujete získat informace o myši, když dojde k dvojitému kliknutí.
MouseDown K této události dochází, když je ukazatel myši nad ovládacím prvku a uživatel stiskne tlačítko myši. Obslužná rutina pro tuto událost obdrží argument typu MouseEventArgs.
MouseEnter K této události dochází, když ukazatel myši přejde do ohraničení nebo klientské oblasti ovládacího prvku v závislosti na typu ovládacího prvku. Obslužná rutina pro tuto událost obdrží argument typu EventArgs.
MouseHover K této události dochází, když ukazatel myši zastaví a umístí se nad ovládací prvek. Obslužná rutina pro tuto událost obdrží argument typu EventArgs.
MouseLeave Tato událost nastane, když ukazatel myši opustí ohraničení nebo klientskou oblast ovládacího prvku v závislosti na typu ovládacího prvku. Obslužná rutina pro tuto událost obdrží argument typu EventArgs.
MouseMove K této události dochází, když se ukazatel myši přesune, když je přes ovládací prvek. Obslužná rutina pro tuto událost obdrží argument typu MouseEventArgs.
MouseUp K této události dochází, když je ukazatel myši nad ovládacím prvku a uživatel uvolní tlačítko myši. Obslužná rutina pro tuto událost obdrží argument typu MouseEventArgs.
MouseWheel K této události dochází, když uživatel otočí kolečko myši, zatímco ovládací prvek má fokus. Obslužná rutina pro tuto událost obdrží argument typu MouseEventArgs. Vlastnost MouseEventArgs můžete použít Delta k určení, jak daleko se myš posune.

Informace o myši

Do obslužných rutin událostí myši souvisejících s kliknutím na tlačítko myši a sledováním pohybu myši se odešle klávesa A MouseEventArgs . MouseEventArgs poskytuje informace o aktuálním stavu myši, včetně umístění ukazatele myši v souřadnicích klienta, která tlačítka myši jsou stisknuta a zda se kolečko myši posune. Několik událostí myši, například těch, které jsou vyvolány, když ukazatel myši vstoupil nebo opustil hranice ovládacího prvku, odešle EventArgs obslužné rutině události bez dalších informací.

Pokud chcete znát aktuální stav tlačítek myši nebo umístění ukazatele myši a chcete se vyhnout zpracování události myši, můžete také použít MouseButtons vlastnosti třídy MousePositionControl . MouseButtons vrátí informace o tom, která tlačítka myši jsou aktuálně stisknuta. Vrátí MousePosition souřadnice obrazovky ukazatele myši a je ekvivalentní hodnotě Positionvrácené .

Převod mezi obrazovkovými a klientskými souřadnicemi

Protože některé informace o poloze myši jsou v souřadnicích klienta a některé jsou v souřadnicích obrazovky, může být nutné převést bod z jednoho souřadnicového systému na druhý. Můžete to provést snadno pomocí PointToClient a PointToScreen metod dostupných ve Control třídě.

Chování události standardního kliknutí

Pokud chcete zpracovat události kliknutí myší ve správném pořadí, musíte znát pořadí, ve kterém jsou události kliknutí vyvolány v ovládacích prvcích model Windows Forms. Všechny ovládací prvky model Windows Forms vyvolávají události kliknutí ve stejném pořadí, když je stisknuto a uvolněno jakékoli podporované tlačítko myši, s výjimkou místa, kde je uvedeno v následujícím seznamu pro jednotlivé ovládací prvky. Následující seznam ukazuje pořadí událostí vyvolaných jedním kliknutím na tlačítko myši:

  1. MouseDown Událost.
  2. Click Událost.
  3. MouseClick Událost.
  4. MouseUp Událost.

Toto je pořadí událostí vyvolaných pro dvojité kliknutí na tlačítko myši:

  1. MouseDown Událost.

  2. Click Událost.

  3. MouseClick Událost.

  4. MouseUp Událost.

  5. MouseDown Událost.

  6. DoubleClick Událost.

    To se může lišit v závislosti na tom, zda má daný StandardDoubleClick ovládací prvek nastaven styl bit na truehodnotu . Další informace o tom, jak nastavit ControlStyles bit, naleznete v metodě SetStyle .

  7. MouseDoubleClick Událost.

  8. MouseUp Událost.

Jednotlivé ovládací prvky

Následující ovládací prvky neodpovídají standardnímu chování události kliknutí myší:

Malování chování přepínacích ovládacích prvků

Přepínací ovládací prvky, například ovládací prvky odvozené z ButtonBase třídy, mají v kombinaci s událostmi kliknutí myší následující výrazné chování obrazu:

  1. Uživatel stiskne tlačítko myši.

  2. Ovládací prvek se vykreslí ve stisknutém stavu.

  3. Událost MouseDown je vyvolána.

  4. Uživatel uvolní tlačítko myši.

  5. Ovládací prvek se vykreslí ve vyvýšeném stavu.

  6. Událost Click je vyvolána.

  7. Událost MouseClick je vyvolána.

  8. Událost MouseUp je vyvolána.

    Poznámka:

    Pokud uživatel přesune ukazatel mimo ovládací prvek přepínacího tlačítka, zatímco je tlačítko myši mimo (například přesunutí myši mimo Button ovládací prvek při stisknutí), ovládací prvek přepínacího tlačítka se vykreslí ve vyvýšeném stavu a dojde pouze k MouseUp události. MouseClick V Click této situaci nedojde k událostem.

Viz také