Menu.MenuItemCollection.Contains-Methode

Bestimmt, ob das angegebene MenuItem ein Member der Auflistung ist.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Function Contains ( _
    value As MenuItem _
) As Boolean
'Usage
Dim instance As MenuItemCollection
Dim value As MenuItem
Dim returnValue As Boolean

returnValue = instance.Contains(value)

public bool Contains (
    MenuItem value
)

public:
bool Contains (
    MenuItem^ value
)

public boolean Contains (
    MenuItem value
)

public function Contains (
    value : MenuItem
) : boolean

Parameter

• value
  Das MenuItem, das in der Auflistung gesucht werden soll.

Rückgabewert

true, wenn das MenuItem ein Member der Auflistung ist, andernfalls false.

Hinweise

Mit dieser Methode können Sie bestimmen, ob ein MenuItem ein Member der Auflistung ist, bevor Sie versuchen, Vorgänge für das MenuItem auszuführen. Mit dieser Methode können Sie bestätigen, dass der Auflistung ein MenuItem hinzugefügt wurde oder dass es weiterhin Member der Auflistung ist.

Beispiel

Im Beispiel wird ein Hauptmenü (myMainMenu) mit zwei MenuItem-Objekten (File und Edit) erstellt. Das Menü File enthält die drei Untermenüelemente New, Open und Exit. Mithilfe der Contains-Methode wird überprüft, ob die Auflistung des Menüs File das Element Open enthält. Wenn das Element vorhanden ist, wird das Ergebnis in einem Textfeld angezeigt. Für dieses Programm muss zuvor das FormForm1 erstellt werden.

Public Sub InitializeMenu()
   ' Create the MainMenu object.
   Dim myMainMenu As New MainMenu()
   
   ' Create the MenuItem objects.
   Dim fileMenu As New MenuItem("&File")
   Dim editMenu As New MenuItem("&Edit")
   Dim newFile As New MenuItem("&New")
   Dim openFile As New MenuItem("&Open")
   Dim exitProgram As 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) Then
      MessageBox.Show("The File menu contains 'Open' ", fileMenu.Text)
   End If
End Sub 
'InitializeMenu

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);
    }
}

public:
   void InitializeMenu()
   {
      // Create the MainMenu object.
      MainMenu^ myMainMenu = gcnew MainMenu;
      
      // Create the MenuItem objects.
      MenuItem^ fileMenu = gcnew MenuItem( "&File" );
      MenuItem^ editMenu = gcnew MenuItem( "&Edit" );
      MenuItem^ newFile = gcnew MenuItem( "&New" );
      MenuItem^ openFile = gcnew MenuItem( "&Open" );
      MenuItem^ exitProgram = gcnew 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 );
      }
   }

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Menu.MenuItemCollection-Klasse
Menu.MenuItemCollection-Member
System.Windows.Forms-Namespace