Freigeben über

MenuItem

Das MenuItem Steuerelement stellt einzelne auswählbare Elemente in einem Menu oder ContextMenu dar. MenuItem ist der grundlegende Baustein von Menüsystemen in WPF-Anwendungen und stellt die interaktiven Elemente bereit, auf die Benutzer klicken oder auswählen, um Aktionen auszuführen.

Screenshot eines Menüsteuerelements mit mehreren MenuItem-Steuerelementen.

Beispiele für die Verwendung von Menüs finden Sie unter "Menü: Exmaples".

A Menu dient als Container für MenuItem Objekte, wobei eine Beziehung zwischen übergeordneten und untergeordneten Elementen hergestellt wird, wobei:

  • Das Menüsteuerelement stellt die allgemeine Struktur und das Layout zum Organisieren von Menüelementen bereit.
  • Jedes MenuItem-Objekt stellt einen bestimmten Befehl, eine Option oder ein Untermenü innerhalb dieser Struktur dar.
  • MenuItems können andere MenuItems als untergeordnete Elemente enthalten und hierarchische Untermenüs mit unbegrenzter Tiefe erstellen.
  • MenuItems erben die Formatierungs- und Verhaltenseigenschaften des übergeordneten Menüs, es sei denn, es wird explizit außer Kraft gesetzt.

Mit dieser hierarchischen Beziehung können Sie komplexe Navigationsstrukturen erstellen, von einfachen flachen Menüs bis hin zu tief geschachtelten Untermenüsystemen.

MenuItems unterstützen verschiedene Arten von Verhaltensweisen:

Befehlselemente: MenuItems, die bestimmte Befehle ausführen, wenn darauf geklickt wird. Diese werden in der Regel für Aktionen wie "Datei > öffnen" oder "Kopie bearbeiten" >verwendet.

Checkbare Elemente: MenuItems, die ein- und ausgeschaltet werden können, ähnlich wie Kontrollkästchen. Setzen Sie die Eigenschaft IsCheckable auf true, um dieses Verhalten zu aktivieren.

Trennzeichen: Verwenden Sie Separator Steuerelemente in einem Menü, um verwandte Menüeinträge visuell zu gruppieren.

Untermenüelemente: Menüeinträge, die andere Menüeinträge als untergeordnete Elemente enthalten. Beim Klicken oder Darüberfahren wird ein Untermenü mit zusätzlichen Optionen angezeigt.

Zu den wichtigsten Eigenschaften von MenuItem gehören:

  • Header: Der im Menüelement angezeigte Inhalt.
  • Command: Der Befehl, der beim Auswählen des Elements ausgeführt werden soll.
  • IsCheckable: Gibt an, ob das Element aktiviert und deaktiviert werden kann.
  • IsChecked: Der aktuelle Überprüfte Status eines zu überprüfenden Elements.
  • InputGestureText: Text, der die Tastenkombination für das Element darstellt.
  • Icon: Ein Symbol, das neben dem Menüelementtext angezeigt werden soll.

Wichtige Ereignisse umfassen Click, Checkedund Unchecked.

Stile und Vorlagen

Sie können den Standardwert ControlTemplate ändern, um dem MenuItem Steuerelement eine eindeutige Darstellung zu verleihen. Weitere Informationen finden Sie unter Was sind Formatvorlagen und Vorlagen? Und wie erstellen Sie eine Vorlage für ein Steuerelement.

Content-Eigenschaft

Dieses Steuerelement definiert keine Inhaltseigenschaft.

Bestandteile

In der folgenden Tabelle sind die benannten Teile für das MenuItem Steuerelement aufgeführt.

Teil Typ Description
PART_Popup Popup Das Popup, das die Untermenüelemente enthält.

Wenn Sie ein ControlTemplate für eine MenuItem erstellen, könnte Ihre Vorlage ein ItemsPresenter innerhalb eines ScrollViewer enthalten. Das ItemsPresenter zeigt jedes Element im MenuItem an; das ScrollViewer ermöglicht den Bildlauf innerhalb des MenuItem. Wenn das ItemsPresenter nicht das direkte untergeordnete Element des ScrollViewer ist, müssen Sie dem ItemsPresenter den Namen ItemsPresenter geben.

Visuelle Zustände

In der folgenden Tabelle sind die visuellen Zustände für das MenuItem Steuerelement aufgeführt.

VisualState_Name Visualzustandsgruppe Name Description
Gültig Validierungszustände Das Steuerelement ist gültig und weist keine Überprüfungsfehler auf.
UngültigerFokusiert Validierungszustände Das Steuerelement weist einen Validierungsfehler auf und hat den Tastaturfokus.
InvalidNichtFokussiert Validierungszustände Das Steuerelement weist einen Überprüfungsfehler auf, hat jedoch keinen Tastaturfokus.

Siehe auch

  • Last updated on