Menu Klasse

Definition

Stellt die Basisfunktionen für alle Menüs dar.Represents the base functionality for all menus. Obwohl ToolStripDropDown und ToolStripDropDownMenu Funktionen des Menu-Steuerelements früherer Versionen ersetzen und erweitern, kann Menu aus Gründen der Abwärtskompatibilität und zur künftigen Verwendung beibehalten werden.Although ToolStripDropDown and ToolStripDropDownMenu replace and add functionality to the Menu control of previous versions, Menu is retained for both backward compatibility and future use if you choose.

public ref class Menu abstract : System::ComponentModel::Component
[System.ComponentModel.ListBindable(false)]
public abstract class Menu : System.ComponentModel.Component
type Menu = class
    inherit Component
Public MustInherit Class Menu
Inherits Component
Vererbung
Abgeleitet
Attribute

Beispiele

Im folgenden Codebeispiel wird die abgeleitete-Klasse (MenuItem) verwendet, um eine Menüstruktur für ein Formular zu erstellen.The following code example uses the derived class, MenuItem, to create a menu structure for a form. Im Beispielcode wird ein MenuItem hinzugefügt, das das Menü Element der obersten Ebene darstellt, ein unter Menü Element zur Auswahl eines Schrift Grads hinzufügt und dann zwei unter Menü Elemente zu diesem Menü Element hinzufügt, die große und kleine Schriftart Optionen in einer Anwendung darstellen.The example code adds a MenuItem to represent the top-level menu item, adds a submenu item to it for selecting a font size, and then adds two submenu items to that menu item that represent large and small font choices in an application. Für das Beispiel ist es erforderlich, dass ein MainMenu Objekt mit dem Namen mainMenu1 und vier MenuItem Objekte mit den Namen menuItem1, menuItem2, menuItem3und menuItem4vorhanden sind.The example requires that there is a MainMenu object named mainMenu1 and four MenuItem objects named menuItem1, menuItem2, menuItem3, and 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 die Basisklasse für die Klassen MainMenu, MenuItemund ContextMenu.This class is the base class for the MainMenu, MenuItem, and ContextMenu classes. Eine Instanz dieser Klasse kann nicht erstellt werden.You cannot create an instance of this class. Die Menüs für eine Anwendung bestehen aus MenuItem Objekten.The menus for an application consist of MenuItem objects. Diese können andere MenuItem Objekte enthalten, die unter Menü Elemente darstellen.These can contain other MenuItem objects, representing submenu items. Die MenuItem-Objekte können in einem MainMenu gespeichert werden, um Sie als gesamte Menüstruktur für ein Formular oder eine ContextMenu anzuzeigen, die zum Anzeigen von Kontextmenüs verwendet wird.The MenuItem objects can be stored in a MainMenu for display as an entire menu structure for a form or a ContextMenu that is used to display shortcut menus. Diese Klasse stellt die Funktionalität bereit, die für alle Menü Klassen üblich ist.This class provides functionality that is common for all the menu classes.

Im Gegensatz zu vielen Basisklassen verwendet die Menu-Klasse die abgeleiteten Klassen, um viele ihrer Eigenschaften zu definieren.Unlike many base classes, the Menu class uses its derived classes to define many of its properties. Wenn Sie das Menü in einer MDI-Anwendung (Multiple Document Interface) verwenden, können Sie die MdiListItem-Eigenschaft verwenden, um eine MenuItem anzugeben, in der eine Liste der untergeordneten MDI-Formulare in der Anwendung angezeigt wird.If you are using your menu in a multiple-document interface (MDI) application, you can use the MdiListItem property to specify a MenuItem that displays a list of open MDI child forms in your application. Die MenuItems-Eigenschaft enthält eine Liste von MenuItem Objekten, die in der Menu-Klasse gespeichert sind.The MenuItems property contains a list of MenuItem objects stored in the menu class. Bei einem MainMenu oder ContextMenuenthält diese Eigenschaft alle MenuItem Objekte, die angezeigt werden.For a MainMenu or ContextMenu, this property contains all the MenuItem objects that are displayed. Bei einem MenuItemstellt die MenuItems-Eigenschaft die zugeordneten unter Menü Elemente dar.For a MenuItem, the MenuItems property represents the submenu items associated with it.

Zusätzlich zu den Eigenschaften, die für alle abgeleiteten Menü Klassen bereitgestellt werden, stellt die Menu-Klasse auch Methoden bereit, wie z. b. CloneMenu und MergeMenu, mit denen Sie neue Menüs aus vorhandenen Menüs erstellen und gleichzeitig zwei Menüstrukturen zusammenführen können.In addition to the properties that are provided for all the derived menu classes, the Menu class also provides methods, such as CloneMenu and MergeMenu, that enable you to create new menus from existing menus, and also merge two menu structures together.

Die Menu-Klasse definiert auch die Menu.MenuItemCollectionder-Klasse.The Menu class also defines the nested class Menu.MenuItemCollection. Diese Klasse definiert die Auflistung von MenuItem-Objekten, die von der MenuItems-Eigenschaft verwendet werden.This class defines the collection of MenuItem objects used by the MenuItems property. Sie können die Methoden der Menu.MenuItemCollection-Klasse verwenden, um Menü Elemente einer MainMenu, ContextMenuoder MenuItemhinzuzufügen und zu entfernen.You can use the methods of the Menu.MenuItemCollection class to add and remove menu items from a MainMenu, ContextMenu, or MenuItem.

Konstruktoren

Menu(MenuItem[])

Initialisiert eine neue Instanz der Klasse Menu.Initializes a new instance of the Menu class.

Felder

FindHandle

Gibt an, dass die FindMenuItem(Int32, IntPtr)-Methode nach einem Handle suchen soll.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a handle.

FindShortcut

Gibt an, dass die FindMenuItem(Int32, IntPtr)-Methode nach einer Verknüpfung suchen soll.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a shortcut.

Eigenschaften

CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Geerbt von Component)
Container

Ruft die IContainer ab, die in der Component enthalten ist.Gets the IContainer that contains the Component.

(Geerbt von Component)
DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Geerbt von Component)
Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Geerbt von Component)
Handle

Ruft einen Wert ab, der das Fensterhandle für das Menü darstellt.Gets a value representing the window handle for the menu.

IsParent

Ruft einen Wert ab, der angibt, ob dieses Menü Menüelemente enthält.Gets a value indicating whether this menu contains any menu items. Diese Eigenschaft ist schreibgeschützt.This property is read-only.

MdiListItem

Ruft einen Wert ab, der das MenuItem angibt, mit dem eine Liste von untergeordneten MDI-Formularen (Multiple Document Interface) angezeigt wird.Gets a value indicating the MenuItem that is used to display a list of multiple document interface (MDI) child forms.

MenuItems

Ruft einen Wert ab, der die Auflistung der dem Menü zugeordneten MenuItem-Objekte angibt.Gets a value indicating the collection of MenuItem objects associated with the menu.

Name

Ruft den Namen von Menu ab oder legt ihn fest.Gets or sets the name of the Menu.

Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Geerbt von Component)
Tag

Ruft benutzerdefinierte, dem Steuerelement zugeordnete Daten ab oder legt diese fest.Gets or sets user-defined data associated with the control.

Methoden

CloneMenu(Menu)

Kopiert das Menu, das als Parameter an das aktuelle Menu übergeben wird.Copies the Menu that is passed as a parameter to the current Menu.

CreateMenuHandle()

Erstellt ein neues Handle für Menu.Creates a new handle to the Menu.

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle von Component verwendeten Ressourcen frei.Releases all resources used by the Component.

(Geerbt von Component)
Dispose(Boolean)

Gibt mit Ausnahme des Speichers die von der Menu-Klasse verwendeten Ressourcen frei.Disposes of the resources, other than memory, used by the Menu.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
FindMenuItem(Int32, IntPtr)

Ruft das MenuItem ab, das den angegebenen Wert enthält.Gets the MenuItem that contains the value specified.

FindMergePosition(Int32)

Gibt die Position zurück, an der ein Menüelement in das Menü eingefügt werden soll.Returns the position at which a menu item should be inserted into the menu.

GetContextMenu()

Ruft das ContextMenu ab, das dieses Menü enthält.Gets the ContextMenu that contains this menu.

GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
GetMainMenu()

Ruft das MainMenu ab, das dieses Menü enthält.Gets the MainMenu that contains this menu.

GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Geerbt von Component)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Geerbt von MarshalByRefObject)
MergeMenu(Menu)

Führt die MenuItem-Objekte eines Menüs mit dem aktuellen Menü zusammen.Merges the MenuItem objects of one menu with the current menu.

ProcessCmdKey(Message, Keys)

Verarbeitet eine Befehlstaste.Processes a command key.

ToString()

Gibt einen String zurück, der das Menu-Steuerelement darstellt.Returns a String that represents the Menu control.

Ereignisse

Disposed

Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird.Occurs when the component is disposed by a call to the Dispose() method.

(Geerbt von Component)

Gilt für:

Siehe auch