This documentation is archived and is not being maintained.

Form.Menu Property

Gets or sets the MainMenu that is displayed in the form.

[Visual Basic]
Public Property Menu As MainMenu
[C#]
public MainMenu Menu {get; set;}
[C++]
public: __property MainMenu* get_Menu();
public: __property void set_Menu(MainMenu*);
[JScript]
public function get Menu() : MainMenu;
public function set Menu(MainMenu);

Property Value

A MainMenu that represents the menu to display in the form.

Remarks

You can use this property to switch between complete menu sets at run time. For example, you can define one MainMenu to be displayed when your multiple document interface (MDI) form has no active MDI child forms and another MainMenu to display when a child window is displayed. You can also use a different MainMenu when specific conditions exist in your application that require displaying a different menu set.

Example

[Visual Basic, C#, C++] The following example creates a MainMenu, assigns two MenuItem objects to the MainMenu and binds it to a form. This example assumes that you have a Form created that is named Form1.

[Visual Basic] 
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


[C#] 
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;   
}


[C++] 
public:
 void CreateMyMainMenu()
 {
    // Create an empty MainMenu.
    MainMenu* mainMenu1 = new MainMenu();
 
    MenuItem* menuItem1 = new MenuItem();
    MenuItem* menuItem2 = new MenuItem();
 
    menuItem1->Text = S"File";
    menuItem2->Text = S"Edit";
    // Add two MenuItem objects to the MainMenu.
    mainMenu1->MenuItems->Add(menuItem1);
    mainMenu1->MenuItems->Add(menuItem2);
    
    // Bind the MainMenu to Form1.
    Menu = mainMenu1;   
 }
 

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

Form Class | Form Members | System.Windows.Forms Namespace | MainMenu | MenuItem | Menu

Show: