Menu.GetMainMenu-Methode

Ruft das MainMenu ab, das dieses Menü enthält.

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

Syntax

'Declaration
Public Function GetMainMenu As MainMenu
'Usage
Dim instance As Menu
Dim returnValue As MainMenu

returnValue = instance.GetMainMenu

public MainMenu GetMainMenu ()

public:
MainMenu^ GetMainMenu ()

public MainMenu GetMainMenu ()

public function GetMainMenu () : MainMenu

Rückgabewert

Das MainMenu, das dieses Menü enthält.

Hinweise

Mit dieser Methode können Sie einen Verweis auf das MainMenu abrufen, in dem dieses Menü derzeit enthalten ist. Diese Eigenschaft gibt NULL (Nothing in Visual Basic) zurück, wenn das Menü nicht in einem MainMenu enthalten ist. Dies kann der Fall sein, wenn das Menü in einem MenuItem bzw. ContextMenu oder aber in keinem Menü enthalten ist. Mit dieser Eigenschaft können Sie ermitteln, ob und wo das Menü derzeit verwendet wird.

Beispiel

In diesem Beispiel werden MainMenu, mainMenu1 sowie die vier Menüelemente menuItem1, menuItem2, menuItem3 und menuItem4 deklariert. Nur die ersten drei Menüelemente werden mainMenu1 für die Anzeige hinzugefügt. Das Programm überprüft dann, ob menuItem3 verwendet wird, d. h. auf true festgelegt ist, und bestimmt das Formular, in dem es verwendet wird. Für die Anzeige des Namens des Hostformulars für MainMenu wird ein Beschriftungstext verwendet. Wenn das getestete Menüelement in menuItem4 geändert wird, dann wird die Bedingung mit false ausgewertet, da menuItem4 nie verwendet wurde. Bei diesem Beispiel ist es erforderlich, dass ein Form mit dem Namen MyForm erstellt wurde, das ein Label mit dem Namen label1 enthält.

Private Sub InitializeMyMainMenu()
    ' Create the MainMenu and the menu items to add.
    Dim mainMenu1 As New MainMenu()

    Dim menuItem1 As New MenuItem()
    Dim menuItem2 As New MenuItem()
    Dim menuItem3 As New MenuItem()
    Dim menuItem4 As New MenuItem()


    ' Set the caption for the menu items.
    menuItem1.Text = "File"
    menuItem2.Text = "Edit"
    menuItem3.Text = "View"

    ' Add 3 menu items to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1)
    mainMenu1.MenuItems.Add(menuItem2)
    mainMenu1.MenuItems.Add(menuItem3)

    ' Assign mainMenu1 to the form.
    Menu = mainMenu1

    ' Determine whether menuItem3 is currently being used.
    If Not (menuItem3.GetMainMenu() Is Nothing) Then
        ' Display the name of the form in which it is located.
        Label1.Text = menuItem3.GetMainMenu().GetForm().ToString()
    End If
End Sub 'InitializeMyMainMenu 

private void InitializeMyMainMenu()
{
    // Create the MainMenu and the menu items to add.
    MainMenu mainMenu1 = new MainMenu();

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

   
    // Set the caption for the menu items.
    menuItem1.Text = "File";
    menuItem2.Text = "Edit";
    menuItem3.Text = "View";

    // Add 3 menu items to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1);
    mainMenu1.MenuItems.Add(menuItem2);
    mainMenu1.MenuItems.Add(menuItem3);

    // Assign mainMenu1 to the form.
    Menu = mainMenu1;

    // Determine whether menuItem3 is currently being used.
    if(menuItem3.GetMainMenu() != null)
        // Display the name of the form in which it is located.
        label1.Text= menuItem3.GetMainMenu().GetForm().ToString();
}

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu and the menu items to add.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      MenuItem^ menuItem1 = gcnew MenuItem;
      MenuItem^ menuItem2 = gcnew MenuItem;
      MenuItem^ menuItem3 = gcnew MenuItem;
      MenuItem^ menuItem4 = gcnew MenuItem;

      // Set the caption for the menu items.
      menuItem1->Text = "File";
      menuItem2->Text = "Edit";
      menuItem3->Text = "View";

      // Add 3 menu items to the MainMenu for displaying.
      mainMenu1->MenuItems->Add( menuItem1 );
      mainMenu1->MenuItems->Add( menuItem2 );
      mainMenu1->MenuItems->Add( menuItem3 );

      // Assign mainMenu1 to the form.
      Menu = mainMenu1;

      // Determine whether menuItem3 is currently being used.
      if ( menuItem3->GetMainMenu() != nullptr )

      // Display the name of the form in which it is located.
      label1->Text = menuItem3->GetMainMenu()->GetForm()->ToString();
   }

private void InitializeMyMainMenu()
{        
    // Create the MainMenu and the menu items to add.
    MainMenu mainMenu1 = new MainMenu();
    MenuItem menuItem1 = new MenuItem();
    MenuItem menuItem2 = new MenuItem();
    MenuItem menuItem3 = new MenuItem();
    MenuItem menuItem4 = new MenuItem();

    // Set the caption for the menu items.
    menuItem1.set_Text("File");
    menuItem2.set_Text("Edit");
    menuItem3.set_Text("View");

    // Add 3 menu items to the MainMenu for displaying.
    mainMenu1.get_MenuItems().Add(menuItem1);
    mainMenu1.get_MenuItems().Add(menuItem2);
    mainMenu1.get_MenuItems().Add(menuItem3);

    // Assign mainMenu1 to the form.
    set_Menu(mainMenu1);

    // Determine whether menuItem3 is currently being used.
    if (menuItem3.GetMainMenu() != null) {
        // Display the name of the form in which it is located.
        label1.set_Text(menuItem3.GetMainMenu().GetForm().ToString());
    }
} //InitializeMyMainMenu

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

Siehe auch

Referenz

Menu-Klasse
Menu-Member
System.Windows.Forms-Namespace
GetContextMenu