Menu Menu Menu Menu Class

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- MenuItemKlasse 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. Das Beispiel setzt voraus, dass es MainMenu ein- mainMenu1 Objekt mit MenuItem dem Namen und menuItem2vier-Objekte menuItem4mit den Namen menuItem1,, menuItem3und gibt.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 MainMenuKlassen MenuItem, und 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 MenuItem aus-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 einer MainMenu als gesamte Menüstruktur für ein Formular oder ein ContextMenu gespeichert werden, das 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 Menu verwendet die-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 ein MenuItem anzugeben, das eine Liste der untergeordneten MDI-Formulare in der Anwendung anzeigt.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 MenuItem von-Objekten, die in der Menu-Klasse gespeichert sind.The MenuItems property contains a list of MenuItem objects stored in the menu class. Für ein MainMenu - ContextMenuoder-Objekt enthält MenuItem diese Eigenschaft alle-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 ihm 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, Menu stellt die CloneMenu -Klasse auch Methoden bereit, MergeMenuwie z. b. und, mit denen Sie neue Menüs aus vorhandenen Menüs erstellen und außerdem zwei Menüstrukturen zusammenführen können. trafen.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.MenuItemCollection-Klasse.The Menu class also defines the nested class Menu.MenuItemCollection. Diese Klasse definiert die Auflistung von MenuItem -Objekten, die MenuItems von der-Eigenschaft verwendet werden.This class defines the collection of MenuItem objects used by the MenuItems property. Sie können die Methoden Menu.MenuItemCollection der-Klasse verwenden, um Menü Elemente MainMenuvon, 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[]) Menu(MenuItem[]) Menu(MenuItem[]) Menu(MenuItem[])

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

Felder

FindHandle FindHandle FindHandle 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 FindShortcut FindShortcut 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 CanRaiseEvents CanRaiseEvents 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.

(Inherited from Component)
Container Container Container Container

Ruft den IContainer ab, der die Component enthält.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode 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.

(Inherited from Component)
Events Events Events 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.

(Inherited from Component)
Handle Handle Handle Handle

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

IsParent IsParent IsParent 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 MdiListItem MdiListItem 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 MenuItems MenuItems 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 Name Name Name

Ruft den Namen der Menu ab oder legt diesen fest.Gets or sets the name of the Menu.

Site Site Site Site

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

(Inherited from Component)
Tag Tag Tag 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) CloneMenu(Menu) CloneMenu(Menu) 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() CreateMenuHandle() CreateMenuHandle() CreateMenuHandle()

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

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

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

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) 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) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr)

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

FindMergePosition(Int32) FindMergePosition(Int32) FindMergePosition(Int32) 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() GetContextMenu() GetContextMenu() GetContextMenu()

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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.

(Inherited from MarshalByRefObject)
GetMainMenu() GetMainMenu() GetMainMenu() GetMainMenu()

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

GetService(Type) GetService(Type) GetService(Type) 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.

(Inherited from Component)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
MergeMenu(Menu) MergeMenu(Menu) MergeMenu(Menu) 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) ProcessCmdKey(Message, Keys) ProcessCmdKey(Message, Keys) ProcessCmdKey(Message, Keys)

Verarbeitet eine Befehlstaste.Processes a command key.

ToString() ToString() ToString() ToString()

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

Ereignisse

Disposed Disposed Disposed Disposed

Tritt ein, wenn die Komponente durch einen Aufruf der Dispose()-Methode freigegeben wird.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Gilt für:

Siehe auch