Freigeben über


Menu Klasse

Definition

Stellt die Basisfunktionen für alle Menüs dar.

Diese Klasse ist in .NET Core 3.1 und höheren Versionen nicht verfügbar. Verwenden Sie stattdessen ToolStripDropDown und ToolStripDropDownMenu. Dadurch wird das Menu-Steuerelement ersetzt und erweitert.

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
Abgeleitet
Attribute

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

Menu(MenuItem[])

Initialisiert eine neue Instanz der Menu-Klasse.

Felder

FindHandle

Gibt an, dass die FindMenuItem(Int32, IntPtr)-Methode nach einem Handle suchen soll.

FindShortcut

Gibt an, dass die FindMenuItem(Int32, IntPtr)-Methode nach einer Verknüpfung suchen soll.

Eigenschaften

CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.

(Geerbt von Component)
Container

Ruft die IContainer ab, die in der Component enthalten ist.

(Geerbt von Component)
DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.

(Geerbt von Component)
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.

IsParent

Ruft einen Wert ab, der angibt, ob dieses Menü Menüelemente enthält. Diese Eigenschaft ist schreibgeschützt.

MdiListItem

Ruft einen Wert ab, der das MenuItem angibt, mit dem eine Liste von untergeordneten MDI-Formularen (Multiple Document Interface) angezeigt wird.

MenuItems

Ruft einen Wert ab, der die Auflistung der dem Menü zugeordneten MenuItem-Objekte angibt.

Name

Ruft den Namen der Menu ab 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.

Methoden

CloneMenu(Menu)

Kopiert das Menu, das als Parameter an das aktuelle Menu übergeben wird.

CreateMenuHandle()

Erstellt ein neues Handle für 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 mit Ausnahme des Speichers die von der Menu-Klasse verwendeten Ressourcen 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.

FindMergePosition(Int32)

Gibt die Position zurück, an der ein Menüelement in das Menü eingefügt werden soll.

GetContextMenu()

Ruft das ContextMenu ab, das dieses Menü enthält.

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.

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(Menu)

Führt die MenuItem-Objekte eines Menüs mit dem aktuellen Menü zusammen.

ProcessCmdKey(Message, Keys)

Verarbeitet eine Befehlstaste.

ToString()

Gibt einen String zurück, der das Menu-Steuerelement darstellt.

Ereignisse

Disposed

Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird.

(Geerbt von Component)

Gilt für

Siehe auch