Menu 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 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: 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 , ContextMenu MenuItemoder 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