Freigeben über

Steuern von Ereignissen (Windows Forms .NET)

  • Artikel

Steuerelemente stellen Ereignisse zur Verfügung, die ausgelöst werden, wenn der Benutzer mit dem Steuerelement interagiert oder wenn sich der Zustand des Steuerelements ändert. In diesem Artikel werden die allgemeinen Ereignisse beschrieben, die von den meisten Steuerelementen gemeinsam genutzt werden, ereignisse, die durch Benutzerinteraktion ausgelöst werden, und Ereignisse, die für bestimmte Steuerelemente spezifisch sind. Weitere Informationen zu Ereignissen in Windows Forms finden Sie unter Übersicht über Ereignisse und Behandeln und Auslösen von Ereignissen.

Wichtig

Der Desktopleitfaden zu .NET 7 und .NET 6 ist in Bearbeitung.

Weitere Informationen zum Hinzufügen oder Entfernen eines Steuerelementereignishandlers finden Sie unter Behandeln eines Ereignisses.

Allgemeine Ereignisse

Steuerelemente stellen über die Basisklasse Control mehr als 60 Ereignisse bereit. Dazu gehören das Paint-Ereignis, das die Zeichnung eines Steuerelements verursacht, Ereignisse für die Anzeige eines Fenster, wie z. B. die Ereignisse Resize und Layout, sowie Maus- und Tastaturereignisse auf niedriger Ebene. Einige Ereignisse auf niedriger Ebene werden von Control zu semantischen Ereignissen wie Click und DoubleClick synthetisiert. Die meisten freigegebenen Ereignisse fallen in diese Kategorien:

  • Mausereignisse
  • Tastaturereignisse
  • Durch geänderte Eigenschaften ausgelöste Ereignisse
  • Sonstige Ereignisse

Mausereignisse

Da Windows Forms eine Benutzeroberfläche(UI)-Technologie ist, ist die Mauseingabe die primäre Art und Weise, wie Benutzer mit einer Windows Forms-Anwendung interagieren. Alle Steuerelemente stellen grundlegende mausbezogene Ereignisse zur Verfügung:

Weitere Informationen finden Sie unter Verwenden von Mausereignissen.

Tastaturereignisse

Wenn das Steuerelement auf Benutzereingaben reagiert, z. B. ein TextBoxButton Steuerelement, wird das entsprechende Eingabeereignis für das Steuerelement ausgelöst. Das Steuerelement muss den Fokus haben, um Tastaturereignisse zu empfangen. Einige Steuerelemente, z. B. das Label Steuerelement, können nicht fokussiert sein und können keine Tastaturereignisse empfangen. Im Folgenden finden Sie eine Liste der Tastaturereignisse:

Weitere Information finden Sie unter Verwenden von Tastaturereignissen.

Durch geänderte Eigenschaften ausgelöste Ereignisse

Windows Forms folgt dem PropertyNameChanged-Muster für Eigenschaften mit Änderungsereignissen. Die von Windows Forms bereitgestellte Datenbindungs-Engine erkennt dieses Muster und lässt sich gut integrieren. Implementieren Sie dieses Muster, wenn Sie eigene Steuerelemente erstellen.

Dieses Muster implementiert die folgenden Regeln mithilfe der Eigenschaft FirstName als Beispiel:

  • Benennen Sie Ihre Eigenschaft: FirstName.
  • Erstellen Sie ein Ereignis für die Eigenschaft mithilfe des Musters PropertyNameChanged: FirstNameChanged.
  • Erstellen Sie eine private oder geschützte Methode mit dem Muster OnPropertyNameChanged: OnFirstNameChanged.

Wenn der FirstName-Eigenschaftssatz den Sicherungswert ändert, wird die OnFirstNameChanged-Methode aufgerufen. Die OnFirstNameChanged-Methode löst das FirstNameChanged-Ereignis aus.

Im Folgenden finden Sie einige der allgemeinen Eigenschaftenänderungsereignisse für ein Steuerelement:

Ereignis BESCHREIBUNG
BackColorChanged Tritt auf, wenn sich der Wert der BackColor-Eigenschaft ändert.
BackgroundImageChanged Tritt auf, wenn sich der Wert der BackgroundImage-Eigenschaft ändert.
BindingContextChanged Tritt auf, wenn sich der Wert der BindingContext-Eigenschaft ändert.
DockChanged Tritt auf, wenn sich der Wert der Dock-Eigenschaft ändert.
EnabledChanged Tritt ein, wenn der Enabled-Eigenschaftswert geändert wurde.
FontChanged Tritt ein, wenn der Font-Eigenschaftswert geändert wird.
ForeColorChanged Tritt ein, wenn der ForeColor-Eigenschaftswert geändert wird.
LocationChanged Tritt ein, wenn der Location-Eigenschaftswert geändert wurde.
SizeChanged Tritt ein, wenn der Size-Eigenschaftswert geändert wird.
VisibleChanged Tritt ein, wenn der Visible-Eigenschaftswert geändert wird.

Eine vollständige Liste der Ereignisse finden Sie im Abschnitt Ereignisse der Steuerelementklasse.

Sonstige Ereignisse

Steuerelemente geben auch Ereignisse basierend auf dem Zustand des Steuerelements oder anderen Interaktionen mit dem Steuerelement aus. Das Ereignis wird beispielsweise ausgelöst, wenn das HelpRequested Steuerelement den Fokus hat und der Benutzer die Taste F1 drückt. Dieses Ereignis wird auch ausgelöst, wenn der Benutzer die Kontextmenü-Hilfeschaltfläche auf einem Formular drückt und dann den Hilfecursor auf dem Steuerelement drückt.

Ein weiteres Beispiel ist, wenn ein Steuerelement geändert, verschoben oder die Größe geändert wird, wird das Paint-Ereignis ausgelöst. Dieses Ereignis bietet dem Entwickler die Möglichkeit, auf das Steuerelement zu zeichnen und seine Darstellung zu ändern.

Eine vollständige Liste der Ereignisse finden Sie im Abschnitt Ereignisse der Steuerelementklasse.

Siehe auch