Menu.MenuItemCollection.Count Property

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets a value indicating the total number of MenuItem objects in the collection.

public:
 property int Count { int get(); };

public int Count { get; }

member this.Count : int

Public ReadOnly Property Count As Integer

Property Value

Int32

The number of MenuItem objects in the collection.

Implements

Count

Examples

The following code example shows how to create a main menu, myMainMenu, with one MenuItem, File, that has three submenu items: New, Open, and Exit. Using the Count property, you count the number of objects in the File menu and display this number in a message box. This example requires that you have already created a Form named Form1.

public:
   void InitializeMyMenu()
   {
      // Create the MainMenu Object*.
      MainMenu^ myMainMenu = gcnew MainMenu;
      
      // Create the MenuItem objects.
      MenuItem^ fileMenu = gcnew MenuItem( "&File" );
      MenuItem^ newFile = gcnew MenuItem( "&New" );
      MenuItem^ openFile = gcnew MenuItem( "&Open" );
      MenuItem^ exitProgram = gcnew MenuItem( "E&xit" );
      
      // Add the File menu item to myMainMenu.
      myMainMenu->MenuItems->Add( fileMenu );
      
      // Add three submenus to the File menu.
      fileMenu->MenuItems->Add( newFile );
      fileMenu->MenuItems->Add( openFile );
      fileMenu->MenuItems->Add( exitProgram );
      
      // Assign myMainMenu to the form.
      this->Menu = myMainMenu;
      
      // Count the number of objects in the File menu and display the result.
      String^ objectNumber = fileMenu->MenuItems->Count.ToString();
      MessageBox::Show( "Number of objects in the File menu = " + objectNumber );
   }

public void InitializeMyMenu()
{
    // Create the MainMenu object.
    MainMenu myMainMenu = new MainMenu();
    
    // Create the MenuItem objects.
    MenuItem fileMenu = new MenuItem("&File");
    MenuItem newFile = new MenuItem("&New");
    MenuItem openFile = new MenuItem("&Open");
    MenuItem exitProgram = new MenuItem("E&xit");
    
    // Add the File menu item to myMainMenu.
    myMainMenu.MenuItems.Add(fileMenu);
    
    // Add three submenus to the File menu.
    fileMenu.MenuItems.Add(newFile);
    fileMenu.MenuItems.Add(openFile);
    fileMenu.MenuItems.Add(exitProgram);
    
    // Assign myMainMenu to the form.
    this.Menu = myMainMenu;
    
    // Count the number of objects in the File menu and display the result.
    string objectNumber = fileMenu.MenuItems.Count.ToString();
    MessageBox.Show("Number of objects in the File menu = " + objectNumber);
}

Public Sub InitializeMyMenu()
   ' Create the MainMenu object.
   Dim myMainMenu As New MainMenu()
   
   ' Create the MenuItem objects.
   Dim fileMenu As New MenuItem("&File")
   Dim newFile As New MenuItem("&New")
   Dim openFile As New MenuItem("&Open")
   Dim exitProgram As New MenuItem("E&xit")
   
   ' Add the File menu item to myMainMenu.
   myMainMenu.MenuItems.Add(fileMenu)
   
   ' Add three submenus to the File menu.
   fileMenu.MenuItems.Add(newFile)
   fileMenu.MenuItems.Add(openFile)
   fileMenu.MenuItems.Add(exitProgram)
   
   ' Assign myMainMenu to the form.
   Me.Menu = myMainMenu
   
   ' Count the number of objects in the File menu and display the result.
   Dim objectNumber As String = fileMenu.MenuItems.Count.ToString()
   MessageBox.Show(("Number of objects in the File menu = " + objectNumber))
End Sub 
'InitializeMyMenu

Remarks

The Count property holds the number of MenuItem objects assigned to the collection. You can use the Count property value as the upper bounds of a loop to iterate through a collection. Keep in mind, the index value of a collection is a zero-based index, so you must subtract one from the looping variable. If you do not account for this, you will exceed the upper bounds of the collection and throw an exception.

Applies to

Product	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0

Share via