Mausereignisse in Windows Forms

Wenn Sie Mauseingaben behandeln, möchten Sie in der Regel die Position des Mauszeigers und den Zustand der Maustasten kennen. Dieses Thema enthält Details zum Abrufen dieser Informationen von Mausereignissen und erörtert die Reihenfolge, in der Mausklickereignisse in Windows Forms-Steuerelementen ausgelöst werden. Eine Liste und Beschreibungen aller Mausereignisse finden Sie unter Funktionsweise von Mauseingabe in Windows Forms. Siehe auch Übersicht über Ereignishandler (Windows Forms) und Ereignisse (Windows Forms).

Mausinformationen

Ein MouseEventArgs wird an Handler von Mausereignissen gesendet, die beim Drücken einer Maustaste und Verfolgen von Mausbewegungen ausgelöst werden. MouseEventArgs enthält Informationen zum aktuellen Zustand der Maus, z. B. die Position des Mauszeigers in Clientkoordinaten, welche Maustasten gedrückt werden und ob das Mausrad bewegt wurde. Zahlreiche Mausereignisse, beispielsweise Ereignisse, die lediglich darüber informieren, dass der Mauszeiger die Grenzen eines Steuerelements überschritten hat, senden ein EventArgs ohne weitere Informationen an den Ereignishandler.

Wenn Sie den aktuellen Zustand der Maustasten oder die Position des Mauszeigers erfahren möchten, ohne ein Mausereignis zu behandeln, können Sie auch die MouseButtons-Eigenschaft und die MousePosition-Eigenschaft der Control-Klasse verwenden. MouseButtons gibt Informationen darüber zurück, welche Maustasten aktuell gedrückt werden. MousePosition gibt die Bildschirmkoordinaten des Mauszeigers zurück, was dem von Position zurückgegebenen Wert entspricht.

Konvertieren zwischen Bildschirm- und Clientkoordinaten

Da einige Mauspositionsinformationen in Clientkoordinaten und einige in Bildschirmkoordinaten vorhanden sind, müssen Sie möglicherweise einen Punkt aus einem Koordinatensystem in das andere Koordinatensystem konvertieren. Eine einfache Möglichkeit hierzu bieten die PointToClient-Methode und die PointToScreen-Methode der Control-Klasse.

Standardverhalten bei Mausklickereignissen

Wenn Sie Mausklickereignisse in der richtigen Reihenfolge behandeln möchten, müssen Sie die Reihenfolge kennen, in der Mausklickereignisse in Windows Forms-Steuerelementen ausgelöst werden. Wenn eine Maustaste gedrückt und wieder losgelassen wird (unabhängig davon, um welche Maustaste es sich handelt), lösen alle Windows Forms-Steuerelemente Mausklickereignisse in derselben Reihenfolge aus. In der folgenden Liste ist die Reihenfolge der Ereignisse aufgeführt, die bei einem einzelnen Mausklick ausgelöst werden:

1. MouseDown -Ereignis.

2. Click -Ereignis.

3. MouseClick -Ereignis.

4. MouseUp -Ereignis.

In der folgenden Liste ist die Reihenfolge der Ereignisse aufgeführt, die bei einem Doppelklick mit der Maus ausgelöst werden:

1. MouseDown -Ereignis.

2. Click -Ereignis.

3. MouseClick -Ereignis.

4. MouseUp -Ereignis.

5. MouseDown -Ereignis.

6. DoubleClick -Ereignis. (Dies kann abhängig davon variieren, ob für das betreffende Steuerelement das StandardDoubleClick-Stilbit auf true festgelegt ist. Weitere Informationen zum Festlegen eines ControlStyles-Bits finden Sie unter der SetStyle-Methode.)

7. MouseDoubleClick -Ereignis.

8. MouseUp -Ereignis.

Ein Codebeispiel zur Veranschaulichung der Reihenfolge der Mausklickereignisse finden Sie unter Behandeln von Benutzereingabeereignissen in Windows Forms-Steuerelementen.

Einzelne Steuerelemente

Die folgenden Steuerelemente weisen nicht das Standardverhalten bei Mausklickereignissen auf:

• Button

• CheckBox

• ComboBox

• RadioButton

  Hinweis

  Für das ComboBox-Steuerelement tritt das im Folgenden beschriebene Verhalten auf, wenn der Benutzer auf das Bearbeitungsfeld, die Schaltfläche oder ein Element in der Liste klickt.

  • Klick mit der linken Maustaste: Click, MouseClick

  • Klick mit der rechten Maustaste: Es werden keine Klickereignisse ausgelöst.

  • Doppelklick mit der linken Maustaste: Click, MouseClick; Click, MouseClick

  • Doppelklick mit der rechten Maustaste: Es werden keine Klickereignisse ausgelöst.

• TextBox-Steuerelement, RichTextBox-Steuerelement, ListBox-Steuerelement, MaskedTextBox-Steuerelement und CheckedListBox-Steuerelement

  Hinweis

  Das im Folgenden beschriebene Verhalten tritt auf, wenn der Benutzer innerhalb dieser Steuerelemente auf eine beliebige Stelle klickt.

  • Klick mit der linken Maustaste: Click, MouseClick

  • Klick mit der rechten Maustaste: Es werden keine Klickereignisse ausgelöst.

  • Doppelklick mit der linken Maustaste: Click, MouseClick, DoubleClick, MouseDoubleClick

  • Doppelklick mit der rechten Maustaste: Es werden keine Klickereignisse ausgelöst.

• ListView-Steuerelement

  Hinweis

  Das im Folgenden beschriebene Verhalten tritt nur auf, wenn der Benutzer auf die Elemente im ListView-Steuerelement klickt. Wenn der Benutzer im Steuerelement auf eine andere Stelle klickt, werden keine Ereignisse ausgelöst. Neben den weiter unten beschriebenen Ereignissen könnten auch das BeforeLabelEdit-Ereignis und das AfterLabelEdit-Ereignis für Sie von Interesse sein, wenn Sie eine Validierung mit dem ListView-Steuerelement durchführen möchten.

  • Klick mit der linken Maustaste: Click, MouseClick

  • Klick mit der rechten Maustaste: Click, MouseClick

  • Doppelklick mit der linken Maustaste: Click, MouseClick; DoubleClick, MouseDoubleClick

  • Doppelklick mit der rechten Maustaste: Click, MouseClick; DoubleClick, MouseDoubleClick

• TreeView-Steuerelement

  Hinweis

  Das im Folgenden beschriebene Verhalten tritt nur auf, wenn der Benutzer im TreeView-Steuerelement auf die Elemente selbst oder rechts neben sie klickt. Wenn der Benutzer im Steuerelement auf eine andere Stelle klickt, werden keine Ereignisse ausgelöst. Neben den weiter unten beschriebenen Ereignissen könnten auch die Ereignisse BeforeCheck, BeforeSelect, BeforeLabelEdit, AfterSelect, AfterCheck und AfterLabelEdit für Sie von Interesse sein, wenn Sie eine Validierung mit dem TreeView-Steuerelement durchführen möchten.

  • Klick mit der linken Maustaste: Click, MouseClick

  • Klick mit der rechten Maustaste: Click, MouseClick

  • Doppelklick mit der linken Maustaste: Click, MouseClick; DoubleClick, MouseDoubleClick

  • Doppelklick mit der rechten Maustaste: Click, MouseClick; DoubleClick, MouseDoubleClick

Zeichnungsverhalten umschaltbarer Steuerelemente

Umschaltbare Steuerelemente, wie die Steuerelemente, die von der ButtonBase-Klasse abgeleitet werden, weisen bei Mausklickereignissen das folgende Zeichnungsverhalten auf:

1. Der Benutzer drückt die Maustaste.

2. Das Steuerelement zeichnet im gedrückten Zustand.

3. Das MouseDown-Ereignis wird ausgelöst.

4. Der Benutzer lässt die Maustaste los.

5. Das Steuerelement zeichnet im erhöhten Zustand.

6. Das Click-Ereignis wird ausgelöst.

7. Das MouseClick-Ereignis wird ausgelöst.

8. Das MouseUp-Ereignis wird ausgelöst.

   Hinweis

   Wenn der Benutzer den Mauszeiger bei gedrückter Maustaste aus dem umschaltbaren Steuerelement bewegt (z. B. wenn er die Maus bei gedrückter Maustaste vom Button-Steuerelement weg bewegt), zeichnet das umschaltbare Steuerelement im erhöhten Zustand, und es tritt nur das MouseUp-Ereignis auf. Das Click-Ereignis oder das MouseClick-Ereignis tritt in dieser Situation nicht auf.

Siehe auch

• Mauseingabe in einer Windows Forms-Anwendung