MainMenu-Klasse

Artikel
08/20/2007

Stellt die Menüstruktur eines Formulars dar. Obwohl MenuStrip Funktionen des MainMenu-Steuerelements früherer Versionen ersetzt und erweitert, kann MainMenu aus Gründen der Abwärtskompatibilität und zur künftigen Verwendung beibehalten werden.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Class MainMenu
    Inherits Menu
'Usage
Dim instance As MainMenu

public class MainMenu : Menu

public ref class MainMenu : public Menu

public class MainMenu extends Menu

public class MainMenu extends Menu

Hinweise

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. Jedes MenuItem kann ein Befehl für die Anwendung oder ein übergeordnetes Menü für andere Untermenüelemente sein. Um ein MainMenu an ein Form zu binden, in dem es angezeigt wird, weisen Sie das MainMenu der Menu-Eigenschaft von Form zu.

In Anwendungen, die mehrere Sprachen unterstützen, können Sie mit der RightToLeft-Eigenschaft den Menütext von rechts nach links anzeigen lassen, um Sprachen wie Arabisch zu unterstützen.

Sie können verschiedene MainMenu-Objekte erstellen, um unterschiedliche Menüstrukturen für das Formular darzustellen. Wenn Sie die in einem bestimmten MainMenu enthaltene Menüstruktur erneut verwenden möchten, können Sie mithilfe der entsprechenden CloneMenu-Methode eine Kopie erstellen. Nachdem eine Kopie der Menüstruktur erstellt wurde, können Sie die entsprechenden Änderungen für die Menüstruktur vornehmen.

Hinweis

Ausschneiden und Einfügen von Menüelementen aus einem Formular in ein anderes im Designer funktioniert möglicherweise nicht wie erwartet, wenn in dem Formular, in das eingefügt wird, keine Menüelemente definiert sind.

Beispiel

Im folgenden Codebeispiel wird ein MainMenu erstellt. Anschließend werden dem MainMenu zwei MenuItem-Objekte zugewiesen, und es wird an ein Formular gebunden. Bei diesem Beispiel ist es erforderlich, dass zuvor ein Form mit dem Namen Form1 erstellt wurde.

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

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;   
}

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.set_Text("File");
    menuItem2.set_Text("Edit");

    // Add two MenuItem objects to the MainMenu.
    mainMenu1.get_MenuItems().Add(menuItem1);
    mainMenu1.get_MenuItems().Add(menuItem2);

    // Bind the MainMenu to Form1.
    set_Menu(mainMenu1);
} //CreateMyMainMenu

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Menu
        System.Windows.Forms.MainMenu

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

MainMenu-Member
System.Windows.Forms-Namespace
MenuItem
Menu.MenuItemCollection.Add
Form.Menu-Eigenschaft
Menu.MenuItems
MenuStrip
ContextMenuStrip-Klasse

Weitere Ressourcen

MenuStrip-Steuerelement (Windows Forms)

Freigeben über