Menu Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

Menu.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 die Basisfunktionalität für alle Menüs dar.

Diese Klasse ist in .NET Core 3.1 und höheren Versionen nicht verfügbar. Verwenden ToolStripDropDown Sie stattdessen ToolStripDropDownMenu die Steuerelemente, die das Menu Steuerelement ersetzen und erweitern.

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

[System.ComponentModel.ListBindable(false)]
[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 abstract class Menu : System.ComponentModel.Component

[<System.ComponentModel.ListBindable(false)>]
[<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 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 BrowsableAttribute ObsoleteAttribute

Beispiele

Im folgenden Codebeispiel wird die abgeleitete Klasse verwendet, MenuItemum eine Menüstruktur für ein Formular zu erstellen. 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 ToolStripDropDown und ToolStripDropDownMenu.

Diese Klasse ist die Basisklasse für die MainMenu, die MenuItem und die 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 für MainMenu die Anzeige als gesamte Menüstruktur für ein Formular oder ein ContextMenu Formular gespeichert werden, das zum Anzeigen von Kontextmenüs verwendet wird. Diese Klasse stellt Funktionen bereit, die für alle Menüklassen 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 mithilfe der MdiListItem Eigenschaft eine MenuItem Liste geöffneter untergeordneter MDI-Formulare in Ihrer Anwendung angeben. Die MenuItems Eigenschaft enthält eine Liste von MenuItem Objekten, die in der Menüklasse gespeichert sind. Für eine oder ContextMenumehrere MainMenu Objekte enthält diese Eigenschaft alle MenuItem angezeigten Objekte. Bei einem MenuItemObjekt stellt die MenuItems Eigenschaft die damit verknüpften Untermenüelemente dar.

Zusätzlich zu den Eigenschaften, die für alle abgeleiteten Menüklassen bereitgestellt werden, stellt die Menu Klasse auch Methoden bereit, z CloneMenu . 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 MainMenu, , ContextMenuoder MenuItem.

Konstruktoren

Name	Beschreibung
Menu(MenuItem[])	Veraltet. Initialisiert eine neue Instanz der Menu-Klasse.

Felder

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

Eigenschaften

Name	Beschreibung
Handle	Veraltet. Ruft einen Wert ab, der das Fensterhandle für das Menü darstellt.
IsParent	Veraltet. Ruft einen Wert ab, der angibt, ob dieses Menü menüelemente enthält. Diese Eigenschaft ist schreibgeschützt.
MdiListItem	Veraltet. Ruft einen Wert ab, der angibt MenuItem , dass zum Anzeigen einer Liste mit untergeordneten Formularen für mehrere Dokumentschnittstellen (MDI) verwendet wird.
MenuItems	Veraltet. Ruft einen Wert ab, der die Auflistung von MenuItem Objekten angibt, die dem Menü zugeordnet sind.
Name	Veraltet. Dient zum Abrufen oder Festlegen des Namens der Menu.
Tag	Veraltet. Ruft benutzerdefinierte Daten ab, die dem Steuerelement zugeordnet sind, oder legt diese fest.

Methoden

Name	Beschreibung
CloneMenu(Menu)	Veraltet. Kopiert das Menu als Parameter übergebene Element in den aktuellen Menu.
CreateMenuHandle()	Veraltet. Erstellt einen neuen Handle für die Menu.
FindMenuItem(Int32, IntPtr)	Veraltet. Ruft den MenuItem angegebenen Wert ab.
FindMergePosition(Int32)	Veraltet. Gibt die Position zurück, an der ein Menüelement in das Menü eingefügt werden soll.
GetContextMenu()	Veraltet. Ruft das Menü ab, das ContextMenu dieses Menü enthält.
GetMainMenu()	Veraltet. Ruft das Menü ab, das MainMenu dieses Menü enthält.
MergeMenu(Menu)	Veraltet. Führt die MenuItem Objekte eines Menüs mit dem aktuellen Menü zusammen.
ProcessCmdKey(Message, Keys)	Veraltet. Verarbeitet eine Befehlstaste.

Weitere Informationen

• MainMenu
• ContextMenu
• MenuItem