MenuItem Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

MenuItem.cs

Achtung

Menu is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use ToolStripDropDown and ToolStripDropDownMenu instead.

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

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

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class MenuItem : System.Windows.Forms.Menu

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type MenuItem = class
    inherit Menu

Public Class MenuItem
Inherits Menu

Vererbung

Object

MarshalByRefObject

Component

Menu

MenuItem

Attribute

BrowsableAttribute ObsoleteAttribute

Beispiele

Im folgenden Codebeispiel wird eine Menüstruktur für ein Formular erstellt. Der Beispielcode fügt ein MenuItem , um das Menüelement der obersten Ebene darzustellen, fügt ein Untermenüelement hinzu, um einen Schriftgrad auszuwählen, und fügt dann zwei Untermenüelemente zu diesem Menüelement hinzu, das große und kleine Schriftartoptionen in einer Anwendung darstellt. Das Beispiel erfordert, dass ein MainMenu Objekt mit dem Namen mainMenu1 und vier MenuItem Objekten mit dem Namen menuItem1, menuItem2, menuItem3und menuItem4.

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 eine MenuItem Anzeige angezeigt werden kann, müssen Sie sie zu einem MainMenu oder .ContextMenu Zum Erstellen von Untermenüs können Sie der MenuItems Eigenschaft des übergeordneten Elements MenuItemObjekte 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 sich gegenseitig ausschließenden Menüelementen ausgewählt ist. Wenn Sie z. B. über eine Reihe von Menüelementen zum Festlegen der Textfarbe in einem TextBox Steuerelement verfügen, können Sie mit der Checked Eigenschaft 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 mithilfe der MergeMenu Methode die Menüs eines übergeordneten MDI-Elements mit der der untergeordneten Formulare zusammenführen, um eine konsolidierte Menüstruktur zu erstellen. Da eine MenuItem Wiederverwendung an mehreren Speicherorten nicht gleichzeitig möglich ist, z. B. in einem MainMenu und einem ContextMenu, können Sie die CloneMenu Methode verwenden, um eine Kopie einer MenuItem für die Verwendung an einem anderen Speicherort zu erstellen.

Mit dem Popup 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 des Codes anzuzeigen oder auszublenden. Mit dem Select Ereignis können Sie Aufgaben ausführen, z. B. detaillierte Hilfe für die Menüelemente Ihrer Anwendung, wenn der Benutzer den Mauszeiger über ein Menüelement platziert.

Konstruktoren

Name	Beschreibung
MenuItem()	Veraltet. Initialisiert eine MenuItem mit einer leeren Beschriftung.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	Veraltet. Initialisiert eine neue Instanz der MenuItem Klasse mit einer angegebenen Beschriftung; definierte Ereignishandler für die ClickEreignisse Select und Popup Ereignisse, eine Tastenkombination, einen Seriendrucktyp und die für das Menüelement angegebene Reihenfolge.
MenuItem(String, EventHandler, Shortcut)	Veraltet. Initialisiert eine neue Instanz der Klasse mit einer angegebenen Beschriftung, einem Ereignishandler und einer zugeordneten Tastenkombination für das Menüelement.
MenuItem(String, EventHandler)	Veraltet. Initialisiert eine neue Instanz der Klasse mit einer angegebenen Beschriftung und einem Ereignishandler für das Click Ereignis des Menüelements.
MenuItem(String, MenuItem[])	Veraltet. Initialisiert eine neue Instanz der Klasse mit einer angegebenen Beschriftung und einem Array von Untermenüelementen, die für das Menüelement definiert sind.
MenuItem(String)	Veraltet. Initialisiert eine neue Instanz der MenuItem Klasse mit einer angegebenen Beschriftung für das Menüelement.

Felder

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

Eigenschaften

Name	Beschreibung
BarBreak	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die MenuItem Position in einer neuen Zeile (für ein Menüelement, das einem MainMenu Objekt hinzugefügt wird) oder in einer neuen Spalte (für ein Untermenüelement oder Menüelement, das in einem ContextMenu) angezeigt wird).
Break	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Element in einer neuen Zeile (für ein Menüelement, das einem MainMenu Objekt hinzugefügt wird) oder in einer neuen Spalte (für ein Menüelement oder Untermenüelement, das in einem ContextMenu) angezeigt wird).
Checked	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob neben dem Text des Menüelements ein Häkchen angezeigt wird.
DefaultItem	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Menüelement das Standardmenüelement ist.
Enabled	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Menüelement aktiviert ist.
Handle	Veraltet. Ruft einen Wert ab, der das Fensterhandle für das Menü darstellt. (Geerbt von Menu)
Index	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der die Position des Menüelements im übergeordneten Menü angibt.
IsParent	Veraltet. Ruft einen Wert ab, der angibt, ob das Menüelement untergeordnete Menüelemente enthält.
MdiList	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Menüelement mit einer Liste der untergeordneten Fenster (Multiple Document Interface, MDI) gefüllt wird, die im zugeordneten Formular angezeigt werden.
MdiListItem	Veraltet. Ruft einen Wert ab, der angibt MenuItem , dass zum Anzeigen einer Liste mit untergeordneten Formularen für mehrere Dokumentschnittstellen (MDI) verwendet wird. (Geerbt von Menu)
MenuID	Veraltet. Ruft einen Wert ab, der den Windows-Bezeichner für dieses Menüelement angibt.
MenuItems	Veraltet. Ruft einen Wert ab, der die Auflistung von MenuItem Objekten angibt, die dem Menü zugeordnet sind. (Geerbt von Menu)
MergeOrder	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der die relative Position des Menüelements angibt, wenn es mit einem anderen zusammengeführt wird.
MergeType	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der das Verhalten dieses Menüelements angibt, wenn das Menü mit einem anderen zusammengeführt wird.
Mnemonic	Veraltet. Ruft einen Wert ab, der das mnemonic-Zeichen angibt, das diesem Menüelement zugeordnet ist.
Name	Veraltet. Dient zum Abrufen oder Festlegen des Namens der Menu. (Geerbt von Menu)
OwnerDraw	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der von Ihnen bereitgestellte Code das Menüelement zeichnet oder Windows das Menüelement zeichnet.
Parent	Veraltet. Ruft einen Wert ab, der das Menü enthält, das dieses Menüelement enthält.
RadioCheck	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das MenuItemOptionsfeld anstelle eines Häkchens angezeigt wird.
Shortcut	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der die dem Menüelement zugeordnete Tastenkombination angibt.
ShowShortcut	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Dem Menüelement zugeordnete Tastenkombination neben der Menüelementbeschriftung angezeigt wird.
Tag	Veraltet. Ruft benutzerdefinierte Daten ab, die dem Steuerelement zugeordnet sind, oder legt diese fest. (Geerbt von Menu)
Text	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der die Beschriftung des Menüelements angibt.
Visible	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Menüelement sichtbar ist.

Methoden

Name	Beschreibung
CloneMenu()	Veraltet. Erstellt eine Kopie der aktuellen MenuItem.
CloneMenu(Menu)	Veraltet. Kopiert das Menu als Parameter übergebene Element in den aktuellen Menu. (Geerbt von Menu)
CloneMenu(MenuItem)	Veraltet. Erstellt eine Kopie der angegebenen MenuItem.
CreateMenuHandle()	Veraltet. Erstellt einen neuen Handle für die Menu. (Geerbt von Menu)
FindMenuItem(Int32, IntPtr)	Veraltet. Ruft den MenuItem angegebenen Wert ab. (Geerbt von Menu)
FindMergePosition(Int32)	Veraltet. Gibt die Position zurück, an der ein Menüelement in das Menü eingefügt werden soll. (Geerbt von Menu)
GetContextMenu()	Veraltet. Ruft das Menü ab, das ContextMenu dieses Menü enthält. (Geerbt von Menu)
GetMainMenu()	Veraltet. Ruft das Menü ab, das MainMenu dieses Menü enthält. (Geerbt von Menu)
MergeMenu()	Veraltet. Führt dies MenuItem mit einem anderen MenuItem zusammen und gibt den resultierenden zusammengeführten Wert zurück MenuItem.
MergeMenu(Menu)	Veraltet. Führt die MenuItem Objekte eines Menüs mit dem aktuellen Menü zusammen. (Geerbt von Menu)
MergeMenu(MenuItem)	Veraltet. Führt ein weiteres Menüelement mit diesem Menüelement zusammen.
OnClick(EventArgs)	Veraltet. Löst das Click-Ereignis aus.
OnDrawItem(DrawItemEventArgs)	Veraltet. Löst das DrawItem-Ereignis aus.
OnInitMenuPopup(EventArgs)	Veraltet. Löst das Popup-Ereignis aus.
OnMeasureItem(MeasureItemEventArgs)	Veraltet. Löst das MeasureItem-Ereignis aus.
OnPopup(EventArgs)	Veraltet. Löst das Popup-Ereignis aus.
OnSelect(EventArgs)	Veraltet. Löst das Select-Ereignis aus.
PerformClick()	Veraltet. Generiert ein Click Ereignis für das MenuItem, das einen Klick durch einen Benutzer simuliert.
PerformSelect()	Veraltet. Löst das Select Ereignis für dieses Menüelement aus.
ProcessCmdKey(Message, Keys)	Veraltet. Verarbeitet eine Befehlstaste. (Geerbt von Menu)

Ereignisse

Name	Beschreibung
Click	Veraltet. Tritt auf, wenn auf das Menüelement mit einer Tastenkombination oder Zugriffstaste geklickt oder ausgewählt wird, die für das Menüelement definiert ist.
DrawItem	Veraltet. Tritt auf, wenn die OwnerDraw Eigenschaft eines Menüelements festgelegt true ist und eine Anforderung zum Zeichnen des Menüelements erfolgt.
MeasureItem	Veraltet. Tritt auf, wenn das Menü vor dem Zeichnen die Größe eines Menüelements kennen muss.
Popup	Veraltet. Tritt auf, bevor die Liste der Menüelemente eines Menüelements angezeigt wird.
Select	Veraltet. Tritt auf, wenn der Benutzer den Mauszeiger über ein Menüelement platziert.

Weitere Informationen

• MainMenu
• Menu
• MenuMerge
• ContextMenu