Export (0) Print
Expand All

Menu.MenuItemCollection.Contains Method

Determines if the specified MenuItem is a member of the collection.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public bool Contains(
	MenuItem value
)

Parameters

value
Type: System.Windows.Forms.MenuItem

The MenuItem to locate in the collection.

Return Value

Type: System.Boolean
true if the MenuItem is a member of the collection; otherwise, false.

This method enables you to determine whether a MenuItem is member of the collection before attempting to perform operations on the MenuItem. You can use this method to confirm that a MenuItem has been added to or is still a member of the collection.

In this example, you create a main menu, myMainMenu, with two MenuItem objects, File and Edit. The File menu has three submenu items, New, Open, and Exit. By using the Contains method, you check to see if the File menu collection contains the item Open. If the item exists, you display the result in a text box. This program requires that you have already created a Form named Form1.

public void InitializeMenu()
{
	// Create the MainMenu object.
	MainMenu myMainMenu = new MainMenu();
	
	// Create the MenuItem objects.
	MenuItem fileMenu = new MenuItem("&File");
	MenuItem editMenu = new MenuItem("&Edit");
	MenuItem newFile = new MenuItem("&New");
	MenuItem openFile = new MenuItem("&Open");
	MenuItem exitProgram = new MenuItem("E&xit");
	
	// Add the MenuItem objects to myMainMenu.
	myMainMenu.MenuItems.Add(fileMenu);
	myMainMenu.MenuItems.Add(editMenu);
	
	// Add three submenus to the File menu.
	fileMenu.MenuItems.Add(newFile);
	fileMenu.MenuItems.Add(openFile);
	fileMenu.MenuItems.Add(exitProgram);
	
	// Assign myMainMenu to the form.
	Menu = myMainMenu;
	
	// Check that the File menu contains the Open menu item. 
	if (fileMenu.MenuItems.Contains(openFile))
	{
		MessageBox.Show("The File menu contains 'Open' ", fileMenu.Text);
	}
}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft