This documentation is archived and is not being maintained.

Menu.MenuItemCollection.Count Property

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

[Visual Basic]
Public Overridable ReadOnly Property Count As Integer  Implements _
   ICollection.Count
[C#]
public virtual int Count {get;}
[C++]
public: __property virtual int get_Count();
[JScript]
public function get Count() : int;

Property Value

The number of MenuItem objects in the collection.

Implements

ICollection.Count

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.

Example

[Visual Basic, C#, C++] In this example, you create a main menu, myMainMenu, with one MenuItem object, 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 program assumes that you have already created a Form named Form1.

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

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

[C++] 
public:
    void InitializeMyMenu() {
        // Create the MainMenu Object*.
        MainMenu* myMainMenu = new MainMenu();

        // Create the MenuItem objects.
        MenuItem* fileMenu = new MenuItem(S"&File");
        MenuItem* newFile = new MenuItem(S"&New");
        MenuItem* openFile = new MenuItem(S"&Open");
        MenuItem* exitProgram = new MenuItem(S"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(String::Concat(
            S"Number of objects in the File menu = ", objectNumber));
    }

[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

Menu.MenuItemCollection Class | Menu.MenuItemCollection Members | System.Windows.Forms Namespace | MenuItems

Show: