MenuItem Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt ein einzelnes Element dar, das in einem MainMenu oder einem ContextMenu angezeigt wird.

Diese Klasse ist in .NET Core 3.1 und höheren Versionen nicht verfügbar. Verwenden Sie ToolStripMenuItem stattdessen, wodurch das MenuItem -Steuerelement ersetzt wird.

public ref class MenuItem : System::Windows::Forms::Menu

public class MenuItem : System.Windows.Forms.Menu

type MenuItem = class
    inherit Menu

Public Class MenuItem
Inherits Menu

Vererbung: Object

MarshalByRefObject

Component

Menu
MenuItem

Beispiele

Im folgenden Codebeispiel wird eine Menüstruktur für ein Formular erstellt. Der Beispielcode fügt ein MenuItem hinzu, um das Menüelement der obersten Ebene darzustellen, fügt diesem ein Untermenüelement zum Auswählen eines Schriftgrads hinzu und fügt diesem Menüelement dann zwei Untermenüelemente hinzu, die große und kleine Schriftarten in einer Anwendung darstellen. Das Beispiel erfordert, dass ein MainMenu Objekt mit dem Namen mainMenu1 und vier MenuItem Objekte mit den Namen menuItem1, menuItem2menuItem3, und menuItem4vorhanden sind.

public:
   void CreateMyMenu()
   {
      // Set the caption for the top-level menu item.
      menuItem1->Text = "Edit";
      // Set the caption for the first submenu.
      menuItem2->Text = "Font Size";
      // Set the caption for menuItem2's first submenu.
      menuItem3->Text = "Small";
      // Set the checked property to true since this is the default value.
      menuItem3->Checked = true;
      // Define a shortcut key combination for the menu item.
      menuItem3->Shortcut = Shortcut::CtrlS;
      // Set the caption of the second sub menu item of menuItem2.
      menuItem4->Text = "Large";
      // Define a shortcut key combination for the menu item.
      menuItem4->Shortcut = Shortcut::CtrlL;
      // Set the index of the menu item so it is placed below the first submenu item.
      menuItem4->Index = 1;
      // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
      menuItem2->MenuItems->Add( menuItem3 );
      menuItem2->MenuItems->Add( menuItem4 );
      // Add menuItem2 to menuItem1's list of menu items.
      menuItem1->MenuItems->Add( menuItem2 );
      // Add menuItem1 to the MainMenu for displaying.
      mainMenu1->MenuItems->Add( menuItem1 );
   }

public void CreateMyMenu()
    {
    // Set the caption for the top-level menu item.
    menuItem1.Text = "Edit";
    // Set the caption for the first submenu.
    menuItem2.Text = "Font Size";
    // Set the caption for menuItem2's first submenu.
    menuItem3.Text = "Small";
    // Set the checked property to true since this is the default value.
    menuItem3.Checked = true;
    // Define a shortcut key combination for the menu item.
    menuItem3.Shortcut = Shortcut.CtrlS;
    // Set the caption of the second sub menu item of menuItem2.
    menuItem4.Text = "Large";
    // Define a shortcut key combination for the menu item.
    menuItem4.Shortcut = Shortcut.CtrlL;
    // Set the index of the menu item so it is placed below the first submenu item.
    menuItem4.Index = 1;
    // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.MenuItems.Add(menuItem3);
    menuItem2.MenuItems.Add(menuItem4);
    // Add menuItem2 to menuItem1's list of menu items.
    menuItem1.MenuItems.Add(menuItem2);
    // Add menuItem1 to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1);
    }

Public Sub CreateMyMenu()
    ' Set the caption for the top-level menu item.
    menuItem1.Text = "Edit"
    ' Set the caption for the first submenu.
    menuItem2.Text = "Font Size"
    ' Set the caption for menuItem2's first submenu.
    menuItem3.Text = "Small"
    ' Set the checked property to true since this is the default value.
    menuItem3.Checked = True
    ' Define a shortcut key combination for the menu item.
    menuItem3.Shortcut = Shortcut.CtrlS
    ' Set the caption of the second sub menu item of menuItem2.
    menuItem4.Text = "Large"
    ' Define a shortcut key combination for the menu item.
    menuItem4.Shortcut = Shortcut.CtrlL
    ' Set the index of the menu item so it is placed below the first submenu item.
    menuItem4.Index = 1
    ' Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.MenuItems.Add(menuItem3)
    menuItem2.MenuItems.Add(menuItem4)
    ' Add menuItem2 to menuItem1's list of menu items.
    menuItem1.MenuItems.Add(menuItem2)
    ' Add menuItem1 to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1)
End Sub

Hinweise

Diese Klasse ist in .NET Core 3.1 und höheren Versionen nicht verfügbar. Verwenden Sie stattdessen ToolStripMenuItem.

Damit ein MenuItem angezeigt wird, müssen Sie es zu einem MainMenu oder ContextMenuhinzufügen. Zum Erstellen von Untermenüs können Sie der MenuItems -Eigenschaft des übergeordneten MenuItem-Objekts Objekte hinzufügenMenuItem.

Die MenuItem -Klasse stellt Eigenschaften bereit, mit denen Sie die Darstellung und Funktionalität eines Menüelements konfigurieren können. Verwenden Sie die Checked -Eigenschaft, um ein Häkchen neben einem Menüelement anzuzeigen. Sie können dieses Feature verwenden, um ein Menüelement zu identifizieren, das in einer Liste von sich gegenseitig ausschließenden Menüelementen ausgewählt ist. Wenn Sie beispielsweise über eine Reihe von Menüelementen zum Festlegen der Textfarbe in einem TextBox Steuerelement verfügen, können Sie die Checked -Eigenschaft verwenden, um zu ermitteln, welche Farbe derzeit ausgewählt ist. Die Shortcut -Eigenschaft kann verwendet werden, um eine Tastaturkombination zu definieren, die gedrückt werden kann, um das Menüelement auszuwählen.

Für MenuItem Objekte, die in einer MDI-Anwendung (Multiple Document Interface) angezeigt werden, können Sie die MergeMenu -Methode verwenden, um die Menüs eines übergeordneten MDI-Elements für mit denen der untergeordneten Formulare zusammenzuführen, um eine konsolidierte Menüstruktur zu erstellen. Da ein MenuItem nicht an mehreren Speicherorten gleichzeitig wiederverwendet werden kann, z. B. in und MainMenu , ContextMenukönnen Sie die CloneMenu -Methode verwenden, um eine Kopie eines MenuItem für die Verwendung an einem anderen Speicherort zu erstellen.

Mit Popup dem -Ereignis können Sie Aufgaben ausführen, bevor ein Menü angezeigt wird. Sie können beispielsweise einen Ereignishandler für dieses Ereignis erstellen, um Menüelemente basierend auf dem Status Ihres Codes anzuzeigen oder auszublenden. Mit Select dem Ereignis können Sie Aufgaben ausführen, z. B. detaillierte Hilfe für die Menüelemente Ihrer Anwendung bereitstellen, wenn der Benutzer den Mauszeiger auf ein Menüelement zeigt.

Konstruktoren

MenuItem()	Initialisiert ein MenuItem mit leerer Beschriftung.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	Initialisiert eine neue Instanz der MenuItem-Klasse mit einer angegebenen Beschriftung, definierten Ereignishandlern für die Ereignisse Click, Select und Popup, einer Tastenkombination, einem Zusammenführungstyp und einer Zusammenführungsfolge, die für das Menüelement angegeben sind.
MenuItem(String)	Initialisiert eine neue Instanz der MenuItem-Klasse mit einer angegebenen Beschriftung für das Menüelement.
MenuItem(String, EventHandler)	Initialisiert eine neue Instanz der Klasse mit einer angegebenen Beschriftung und einem Ereignishandler für das Click-Ereignis des Menüelements.
MenuItem(String, EventHandler, Shortcut)	Initialisiert eine neue Instanz der Klasse mit einer angegebenen Beschriftung, einem Ereignishandler und einer zugeordneten Tastenkombination für das Menüelement.
MenuItem(String, MenuItem[])	Initialisiert eine neue Instanz der Klasse mit einer angegebenen Beschriftung und einem Array von Untermenüelementen, die für das Menüelement definiert wurden.

Felder

FindHandle	Gibt an, dass die FindMenuItem(Int32, IntPtr)-Methode nach einem Handle suchen soll. (Geerbt von Menu)
FindShortcut	Gibt an, dass die FindMenuItem(Int32, IntPtr)-Methode nach einer Verknüpfung suchen soll. (Geerbt von Menu)

Eigenschaften

BarBreak	Ruft einen Wert ab, der angibt, ob MenuItem in einer neuen Zeile platziert wird (für ein Menüelement, das einem MainMenu-Objekt hinzugefügt wurde) oder ob es in einer neuen Spalte platziert wird (für ein Untermenüelement oder Menüelement, das in einem ContextMenu angezeigt wird), oder legt diesen Wert fest.
Break	Ruft einen Wert ab, der angibt, ob das Element in einer neuen Zeile platziert wird (für ein Menüelement, das einem MainMenu-Objekt hinzugefügt wurde) oder ob es in einer neuen Spalte platziert wird (für ein Menüelement oder Untermenüelement, das in einem ContextMenu angezeigt wird), oder legt diesen fest.
CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
Checked	Ruft einen Wert ab, der angibt, ob neben dem Text des Menüelements ein Häkchen angezeigt wird, oder legt diesen fest.
Container	Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component)
DefaultItem	Ruft einen Wert ab, der angibt, ob das Menüelement das Standardmenüelement ist, oder legt diesen fest.
DesignMode	Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component)
Enabled	Ruft einen Wert ab, der angibt, ob das Menüelement aktiviert ist, oder legt diesen fest.
Events	Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component)
Handle	Ruft einen Wert ab, der das Fensterhandle für das Menü darstellt. (Geerbt von Menu)
Index	Ruft einen Wert ab, der die Position des Menüelements im übergeordneten Menü angibt, oder legt diesen fest.
IsParent	Ruft einen Wert ab, der angibt, ob das Menüelement untergeordnete Menüelemente enthält.
MdiList	Ruft einen Wert ab, der angibt, ob das Menüelement mit einer Liste der untergeordneten MDI-Fenster (Multiple Document Interface) aufgefüllt wird, die im zugeordneten Formular angezeigt werden, oder legt diesen Wert fest.
MdiListItem	Ruft einen Wert ab, der das MenuItem angibt, mit dem eine Liste von untergeordneten MDI-Formularen (Multiple Document Interface) angezeigt wird. (Geerbt von Menu)
MenuID	Ruft einen Wert ab, der den Windows-Bezeichner für dieses Menüelement angibt.
MenuItems	Ruft einen Wert ab, der die Auflistung der dem Menü zugeordneten MenuItem-Objekte angibt. (Geerbt von Menu)
MergeOrder	Ruft einen Wert ab, der die relative Position des Menüelements beim Merge mit einem anderen angibt, oder legt diesen fest.
MergeType	Ruft einen Wert ab, der das Verhalten dieses Menüelements bei der Zusammenführung des Menüs mit einem anderen angibt, oder legt diesen fest.
Mnemonic	Ruft einen Wert ab, der das diesem Menüelement zugeordnete mnemonische Zeichen angibt.
Name	Ruft den Namen der Menu ab oder legt diesen fest. (Geerbt von Menu)
OwnerDraw	Ruft einen Wert ab, der angibt, ob das Menüelement vom bereitgestellten Code oder von Windows gezeichnet wird, oder legt diesen fest.
Parent	Ruft einen Wert ab, der das Menü angibt, das dieses Menüelement enthält.
RadioCheck	Ruft einen Wert ab, der angibt, ob MenuItem bei Aktivierung statt eines Häkchens ein Optionsfeld anzeigt, oder legt diesen Wert fest.
Shortcut	Ruft einen Wert ab, der die dem Menüelement zugeordnete Tastenkombination angibt, oder legt diesen fest.
ShowShortcut	Ruft einen Wert ab, der angibt, ob die dem Menüelement zugeordnete Tastenkombination neben der Beschriftung des Menüelements angezeigt wird, oder legt diesen fest.
Site	Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
Tag	Ruft benutzerdefinierte, dem Steuerelement zugeordnete Daten ab oder legt diese fest. (Geerbt von Menu)
Text	Ruft einen Wert ab, der die Beschriftung des Menüelements angibt, oder legt diesen fest.
Visible	Ruft einen Wert ab, der angibt, ob das Menüelement sichtbar ist, oder legt diesen fest.

Methoden

CloneMenu()	Erstellt eine Kopie der aktuellen MenuItem.
CloneMenu(Menu)	Kopiert das Menu, das als Parameter an das aktuelle Menu übergeben wird. (Geerbt von Menu)
CloneMenu(MenuItem)	Erstellt eine Kopie des angegebenen MenuItem.
CreateMenuHandle()	Erstellt ein neues Handle für Menu. (Geerbt von Menu)
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component)
Dispose(Boolean)	Gibt die von der MenuItem-Klasse verwendeten Ressourcen (mit Ausnahme des Speichers) frei.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FindMenuItem(Int32, IntPtr)	Ruft das MenuItem ab, das den angegebenen Wert enthält. (Geerbt von Menu)
FindMergePosition(Int32)	Gibt die Position zurück, an der ein Menüelement in das Menü eingefügt werden soll. (Geerbt von Menu)
GetContextMenu()	Ruft das ContextMenu ab, das dieses Menü enthält. (Geerbt von Menu)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetMainMenu()	Ruft das MainMenu ab, das dieses Menü enthält. (Geerbt von Menu)
GetService(Type)	Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
MergeMenu()	Führt dieses MenuItem mit einem anderen MenuItem zusammen und gibt das sich ergebende zusammengeführte MenuItem zurück.
MergeMenu(Menu)	Führt die MenuItem-Objekte eines Menüs mit dem aktuellen Menü zusammen. (Geerbt von Menu)
MergeMenu(MenuItem)	Führt ein anderes Menüelement mit diesem Menüelement zusammen.
OnClick(EventArgs)	Löst das Click-Ereignis aus.
OnDrawItem(DrawItemEventArgs)	Löst das DrawItem-Ereignis aus.
OnInitMenuPopup(EventArgs)	Löst das Popup-Ereignis aus.
OnMeasureItem(MeasureItemEventArgs)	Löst das MeasureItem-Ereignis aus.
OnPopup(EventArgs)	Löst das Popup-Ereignis aus.
OnSelect(EventArgs)	Löst das Select-Ereignis aus.
PerformClick()	Generiert ein Click-Ereignis für MenuItem, wobei ein Mausklick durch einen Benutzer simuliert wird.
PerformSelect()	Löst das Select-Ereignis für dieses Menüelement aus.
ProcessCmdKey(Message, Keys)	Verarbeitet eine Befehlstaste. (Geerbt von Menu)
ToString()	Gibt eine Zeichenfolge zurück, die den MenuItem darstellt.

Ereignisse

Click	Tritt ein, wenn auf das Menüelement geklickt wird oder wenn es unter Verwendung einer für das Menüelement definierten Tastenkombination oder Zugriffstaste ausgewählt wird.
Disposed	Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird. (Geerbt von Component)
DrawItem	Tritt ein, wenn die OwnerDraw-Eigenschaft eines Menüelements auf `true` festgelegt ist und das Zeichnen des Menüelements angefordert wird.
MeasureItem	Tritt ein, wenn dem Menü die Größe eines Menüelements bekannt sein muss, bevor dieses gezeichnet wird.
Popup	Tritt ein, bevor die Liste der Menüelemente eines Menüelements angezeigt wird.
Select	Tritt ein, wenn der Mauszeiger auf ein Menüelement gesetzt wird.

Gilt für:

Freigeben über