Menu Klasse

Definition

public ref class Menu abstract : System::ComponentModel::Component

[System.ComponentModel.ListBindable(false)]
public abstract class Menu : System.ComponentModel.Component

[<System.ComponentModel.ListBindable(false)>]
type Menu = class
    inherit Component

Public MustInherit Class Menu
Inherits Component

Vererbung

Object

MarshalByRefObject

Component

Menu

Abgeleitet

System.Windows.Forms.ContextMenu

System.Windows.Forms.MainMenu

System.Windows.Forms.MenuItem

Attribute

ListBindableAttribute

Beispiele

Im folgenden Codebeispiel wird die abgeleitete Klasse verwendet, MenuItemum eine Menüstruktur für ein Formular zu erstellen. Der Beispielcode fügt dem Menüelement auf oberster Ebene ein MenuItem Element auf oberster Ebene hinzu, fügt ein Untermenüelement hinzu, um eine Schriftgröße 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 namens und vier MenuItem Objekte namens mainMenu1 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 ToolStripDropDown und ToolStripDropDownMenu.

Diese Klasse ist die Basisklasse für die MainMenu, MenuItemund ContextMenu Klassen. Sie können keine Instanz dieser Klasse erstellen. Die Menüs für eine Anwendung bestehen aus MenuItem Objekten. Diese können andere MenuItem Objekte enthalten, die Untermenüelemente darstellen. Die MenuItem Objekte können in einer MainMenu für die Anzeige als gesamte Menüstruktur für ein Formular oder ContextMenu ein Objekt gespeichert werden, das zum Anzeigen von Kontextmenüs verwendet wird. Diese Klasse bietet Funktionen, die für alle Menüklassen häufig verwendet werden.

Im Gegensatz zu vielen Basisklassen verwendet die Menu Klasse ihre abgeleiteten Klassen, um viele seiner Eigenschaften zu definieren. Wenn Sie Ihr Menü in einer MDI-Anwendung (Multiple-Document Interface) verwenden, können Sie die MdiListItem Eigenschaft verwenden, um eine MenuItem Liste der geöffneten MDI-untergeordneten Formulare in Ihrer Anwendung anzugeben. Die MenuItems Eigenschaft enthält eine Liste der Objekte, die MenuItem in der Menüklasse gespeichert sind. Für eine MainMenu oder ContextMenu, diese Eigenschaft enthält alle Objekte, die MenuItem angezeigt werden. Für eine MenuItemEigenschaft stellt die MenuItems Eigenschaft die untermenüelemente dar, die dem Element zugeordnet sind.

Zusätzlich zu den Eigenschaften, die für alle abgeleiteten Menüklassen bereitgestellt werden, bietet die Menu Klasse auch Methoden wie CloneMenu z. B. und MergeMenu, mit denen Sie neue Menüs aus vorhandenen Menüs erstellen können und auch zwei Menüstrukturen zusammenführen.

Die Menu Klasse definiert auch die geschachtelte Klasse Menu.MenuItemCollection. Diese Klasse definiert die Auflistung von Objekten, MenuItem die von der MenuItems Eigenschaft verwendet werden. Sie können die Methoden der Menu.MenuItemCollection Klasse verwenden, um Menüelemente aus einem , ContextMenuMenuItemoder MainMenu.

Konstruktoren

Felder

Eigenschaften

Methoden

Ereignisse

Gilt für

Siehe auch

• MainMenu
• ContextMenu
• MenuItem