MenuItem.IsParent 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 whether the menu item contains child menu items.

public:
 virtual property bool IsParent { bool get(); };

[System.ComponentModel.Browsable(false)]
public override bool IsParent { get; }

[<System.ComponentModel.Browsable(false)>]
member this.IsParent : bool

Public Overrides ReadOnly Property IsParent As Boolean

Property Value

Boolean

true if the menu item contains child menu items; false if the menu is a standalone menu item.

Attributes: BrowsableAttribute

Examples

The following code example determines whether there are any submenus associated with a MenuItem named menuItem1. If any submenus exist, it disables them by setting the Enabled property to false. The example requires that there is a MenuItem created named menuItem1.

void DisableMyChildMenus()
{
   
   // Determine if menuItem2 is a parent menu.
   if ( menuItem2->IsParent)
   {
      
      // Loop through all the submenus.
      for ( int i = 0; i < menuItem2->MenuItems->Count; i++ )
      {
         
         // Disable all of the submenus of menuItem2.
         menuItem2->MenuItems[ i ]->Enabled = false;

      }
   }
}

public void DisableMyChildMenus ()
{
   // Determine if menuItem2 is a parent menu.
   if (menuItem2.IsParent)
   {
      // Loop through all the submenus.
      for(int i = 0; i < menuItem2.MenuItems.Count; i++)
      {
         // Disable all of the submenus of menuItem2.
         menuItem2.MenuItems[i].Enabled = false;
      }
   }
}

Public Sub DisableMyChildMenus()
    ' Determine if menuItem2 is a parent menu.
    If menuItem2.IsParent = True Then
        ' Loop through all the submenus.
        Dim i As Integer
        For i = 0 To menuItem2.MenuItems.Count - 1
            ' Disable all of the submenus of menuItem2.
            menuItem2.MenuItems(i).Enabled = False
        Next i
    End If
End Sub

Remarks

You can use this property with the Parent property to navigate in code through an entire menu structure.

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, 10

Share via