Menu.MenuItemCollection.AddRange(MenuItem[]) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt der Auflistung ein Array von zuvor erstellten MenuItem-Objekten hinzu.

public:
 virtual void AddRange(cli::array <System::Windows::Forms::MenuItem ^> ^ items);

public virtual void AddRange (System.Windows.Forms.MenuItem[] items);

abstract member AddRange : System.Windows.Forms.MenuItem[] -> unit
override this.AddRange : System.Windows.Forms.MenuItem[] -> unit

Public Overridable Sub AddRange (items As MenuItem())

Parameter

items: MenuItem[]

Ein Array von MenuItem-Objekten, die die der Auflistung hinzuzufügenden Menüelemente darstellen.

Beispiele

Im folgenden Codebeispiel wird ein Array erstellt und die Menu.MenuItemCollection Objekte aus zwei MenuItem Objekten in das Array kopiert. Das Beispiel kopiert dann das Array von MenuItem Objekten in die Steuerelementsammlung für einen ContextMenu benannten contextMenu1. In diesem Beispiel sind zwei MenuItem Objekte erforderlich, die Untermenüelemente namens menuItem1 und menuItem2.

private:
   void CopyMyMenus()
   {
      // Create empty array to store MenuItem objects.
      array<MenuItem^>^ myItems = gcnew array<MenuItem^>(
         menuItem1->MenuItems->Count + menuItem2->MenuItems->Count );
      
      // Copy elements of the first MenuItem collection to array.
      menuItem1->MenuItems->CopyTo( myItems, 0 );
      // Copy elements of the second MenuItem collection, after the first set.
      menuItem2->MenuItems->CopyTo( myItems, myItems->Length );
      
      // Add the array to the menu item collection of the ContextMenu.
      contextMenu1->MenuItems->AddRange( myItems );
   }

private void CopyMyMenus()
{
   // Create empty array to store MenuItem objects.
   MenuItem[] myItems = 
      new MenuItem[menuItem1.MenuItems.Count + menuItem2.MenuItems.Count];
   
   // Copy elements of the first MenuItem collection to array.
   menuItem1.MenuItems.CopyTo(myItems, 0);
   // Copy elements of the second MenuItem collection, after the first set.
   menuItem2.MenuItems.CopyTo(myItems, myItems.Length);

   // Add the array to the menu item collection of the ContextMenu.
   contextMenu1.MenuItems.AddRange(myItems);
}

Private Sub CopyMyMenus()
    ' Create empty array to store MenuItem objects.
    Dim myItems(menuItem1.MenuItems.Count + menuItem2.MenuItems.Count) As MenuItem
       
    ' Copy elements of the first MenuItem collection to array.
    menuItem1.MenuItems.CopyTo(myItems, 0)
    ' Copy elements of the second MenuItem collection, after the first set.
    menuItem2.MenuItems.CopyTo(myItems, myItems.Length)
       
    ' Add the array to the menu item collection of the ContextMenu.
    contextMenu1.MenuItems.AddRange(myItems)
End Sub

Hinweise

Sie können mithilfe der Methode schnell eine Gruppe von zuvor erstellten MenuItem Objekten zur Auflistung hinzufügen, anstatt jede MenuItem der Auflistung mithilfe der Add Methode manuell hinzuzufügen. Wenn die Auflistung bereits Objekte enthält MenuItem , fügt das Aufrufen dieser Methode die neuen MenuItem Objekte am Ende der Auflistung hinzu.

Gilt für

Freigeben über