MainMenu 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 Menüstruktur eines Formulars dar.

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

public ref class MainMenu : System::Windows::Forms::Menu

public class MainMenu : System.Windows.Forms.Menu

type MainMenu = class
    inherit Menu

Public Class MainMenu
Inherits Menu

Vererbung: Object

MarshalByRefObject

Component

Menu
MainMenu

Beispiele

Im folgenden Codebeispiel wird ein MainMenuerstellt, das dem zwei MenuItem Objekte MainMenu zuweist und an ein Formular bindet. Dieses Beispiel erfordert, dass Sie eine Form erstellt haben, die den Namen hat Form1.

void CreateMyMainMenu()
{
   // Create an empty MainMenu.
   MainMenu^ mainMenu1 = gcnew MainMenu;
   MenuItem^ menuItem1 = gcnew MenuItem;
   MenuItem^ menuItem2 = gcnew MenuItem;
   menuItem1->Text = "File";
   menuItem2->Text = "Edit";

   // Add two MenuItem objects to the MainMenu.
   mainMenu1->MenuItems->Add( menuItem1 );
   mainMenu1->MenuItems->Add( menuItem2 );

   // Bind the MainMenu to Form1.
   Menu = mainMenu1;
}

public void CreateMyMainMenu()
{
   // Create an empty MainMenu.
   MainMenu mainMenu1 = new MainMenu();

   MenuItem menuItem1 = new MenuItem();
   MenuItem menuItem2 = new MenuItem();

   menuItem1.Text = "File";
   menuItem2.Text = "Edit";
   // Add two MenuItem objects to the MainMenu.
   mainMenu1.MenuItems.Add(menuItem1);
   mainMenu1.MenuItems.Add(menuItem2);
   
   // Bind the MainMenu to Form1.
   Menu = mainMenu1;   
}

Public Sub CreateMyMainMenu()
    ' Create an empty MainMenu.
    Dim mainMenu1 As New MainMenu()
       
    Dim menuItem1 As New MenuItem()
    Dim menuItem2 As New MenuItem()
       
    menuItem1.Text = "File"
    menuItem2.Text = "Edit"
    ' Add two MenuItem objects to the MainMenu.
    mainMenu1.MenuItems.Add(menuItem1)
    mainMenu1.MenuItems.Add(menuItem2)
       
    ' Bind the MainMenu to Form1.
    Menu = mainMenu1
End Sub

Hinweise

Diese Klasse ist in .NET Core 3.1 und höheren Versionen nicht verfügbar. Verwenden Sie stattdessen MenuStrip.

Das MainMenu Steuerelement stellt den Container für die Menüstruktur eines Formulars dar. Ein Menü besteht aus MenuItem Objekten, die die einzelnen Menübefehle in der Menüstruktur darstellen. Jeder MenuItem kann ein Befehl für Ihre Anwendung oder ein übergeordnetes Menü für andere Untermenüelemente sein. Um die an die MainMenu zu binden, die Form es anzeigt, weisen Sie der Menu MainMenu -Eigenschaft des Formzu.

Für Anwendungen, die unterstützung für mehrere Sprachen haben, können Sie die RightToLeft -Eigenschaft verwenden, um den Text des Menüs von rechts nach links anzuzeigen, um Sprachen wie Arabisch zu unterstützen.

Sie können verschiedene MainMenu Objekte erstellen, um unterschiedliche Menüstrukturen für Ihr Formular darzustellen. Wenn Sie die menüstruktur wiederverwenden möchten, die in einem bestimmten MainMenuenthalten ist, können Sie deren CloneMenu Methode verwenden, um eine Kopie zu erstellen. Sobald Sie über eine Kopie der Menüstruktur verfügen, können Sie die entsprechenden Änderungen für Ihre neue Menüstruktur vornehmen.

Hinweis

Das Ausschneiden und Einfügen von Menüelementen von einem Formular in ein anderes im Designer funktioniert möglicherweise nicht wie erwartet, wenn für das Formular, in das Sie einfügen, keine Menüelemente definiert sind.

Konstruktoren

MainMenu()	Initialisiert eine neue Instanz der MainMenu-Klasse ohne angegebene Menüelemente.
MainMenu(IContainer)	Initialisiert eine neue Instanz der MainMenu-Klasse mit dem angegebenen Container.
MainMenu(MenuItem[])	Initialisiert eine neue Instanz von MainMenu mit einer angegebenen Menge von MenuItem-Objekten.

Felder

FindHandle	Gibt an, dass die FindMenuItem(Int32, IntPtr)-Methode nach einem Handle suchen soll. (Geerbt von Menu)
FindShortcut	Gibt an, dass die FindMenuItem(Int32, IntPtr)-Methode nach einer Verknüpfung suchen soll. (Geerbt von Menu)

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. (Geerbt von Menu)
IsParent	Ruft einen Wert ab, der angibt, ob dieses Menü Menüelemente enthält. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Menu)
MdiListItem	Ruft einen Wert ab, der das MenuItem angibt, mit dem eine Liste von untergeordneten MDI-Formularen (Multiple Document Interface) angezeigt wird. (Geerbt von Menu)
MenuItems	Ruft einen Wert ab, der die Auflistung der dem Menü zugeordneten MenuItem-Objekte angibt. (Geerbt von Menu)
Name	Ruft den Namen der Menu ab oder legt diesen fest. (Geerbt von Menu)
RightToLeft	Ruft ab oder legt fest, ob der vom Steuerelement angezeigte Text von rechts nach links angezeigt wird.
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. (Geerbt von Menu)

Methoden

CloneMenu()	Erstellt ein neues MainMenu als Duplikat des aktuellen MainMenu.
CloneMenu(Menu)	Kopiert das Menu, das als Parameter an das aktuelle Menu übergeben wird. (Geerbt von Menu)
CreateMenuHandle()	Erstellt ein neues Handle für das Menü.
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 MainMenu-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. (Geerbt von Menu)
FindMergePosition(Int32)	Gibt die Position zurück, an der ein Menüelement in das Menü eingefügt werden soll. (Geerbt von Menu)
GetContextMenu()	Ruft das ContextMenu ab, das dieses Menü enthält. (Geerbt von Menu)
GetForm()	Ruft das Form ab, das dieses Steuerelement 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. (Geerbt von Menu)
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. (Geerbt von Menu)
OnCollapse(EventArgs)	Löst das Collapse-Ereignis aus.
ProcessCmdKey(Message, Keys)	Verarbeitet eine Befehlstaste. (Geerbt von Menu)
ToString()	Gibt eine Zeichenfolge zurück, die den MainMenu darstellt.

Ereignisse

Collapse	Tritt ein, wenn das Hauptmenü ausgeblendet wird.
Disposed	Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird. (Geerbt von Component)

Gilt für: