ToolBar.ToolBarButtonCollection.AddRange(ToolBarButton[]) 方法

定义

将一个工具栏按钮集合添加到此工具栏按钮集合中。Adds a collection of toolbar buttons to this toolbar button collection.

public:
 void AddRange(cli::array <System::Windows::Forms::ToolBarButton ^> ^ buttons);
public void AddRange (System.Windows.Forms.ToolBarButton[] buttons);
member this.AddRange : System.Windows.Forms.ToolBarButton[] -> unit
Public Sub AddRange (buttons As ToolBarButton())

参数

buttons
ToolBarButton[]

要添加到此 ToolBarButton(包含在数组中)中的 ToolBar.ToolBarButtonCollection 控件的集合。The collection of ToolBarButton controls to add to this ToolBar.ToolBarButtonCollection contained in an array.

示例

下面的代码示例从控件中删除现有的( ToolBarButton ToolBar 如果存在),并向添加四个新对象并将其插入 ToolBarButton ToolBarThe following code example removes an existing ToolBarButton from a ToolBar control if it exists and adds and inserts four new ToolBarButton objects to the ToolBar. 此示例要求具有 Form 具有 ToolBar 控件的。This example requires that you have a Form with a ToolBar control on it.

void AddToolbarButtons( ToolBar^ toolBar )
{
   if (  !toolBar->Buttons->IsReadOnly )
   {
      
      // If toolBarButton1 in in the collection, remove it.
      if ( toolBar->Buttons->Contains( toolBarButton1 ) )
      {
         toolBar->Buttons->Remove( toolBarButton1 );
      }
      
      // Create three toolbar buttons.
      ToolBarButton^ tbb1 = gcnew ToolBarButton( "tbb1" );
      ToolBarButton^ tbb2 = gcnew ToolBarButton( "tbb2" );
      ToolBarButton^ tbb3 = gcnew ToolBarButton( "tbb3" );
      
      // Add toolbar buttons to the toolbar.
      array<ToolBarButton^>^buttons = {tbb2,tbb3};
      toolBar->Buttons->AddRange( buttons );
      toolBar->Buttons->Add( "tbb4" );
      
      // Insert tbb1 into the first position in the collection.
      toolBar->Buttons->Insert( 0, tbb1 );
   }
}
private void AddToolbarButtons(ToolBar toolBar)
{
   if(!toolBar.Buttons.IsReadOnly)
   {
      // If toolBarButton1 in in the collection, remove it.
      if(toolBar.Buttons.Contains(toolBarButton1))
      {
         toolBar.Buttons.Remove(toolBarButton1);
      }
    
      // Create three toolbar buttons.
      ToolBarButton tbb1 = new ToolBarButton("tbb1");
      ToolBarButton tbb2 = new ToolBarButton("tbb2");
      ToolBarButton tbb3 = new ToolBarButton("tbb3");
      
      // Add toolbar buttons to the toolbar.		
      toolBar.Buttons.AddRange(new ToolBarButton[] {tbb2, tbb3});
      toolBar.Buttons.Add("tbb4");
    
      // Insert tbb1 into the first position in the collection.
      toolBar.Buttons.Insert(0, tbb1);
   }
}
Private Sub AddToolbarButtons(toolBar As ToolBar)
   If Not toolBar.Buttons.IsReadOnly Then
      ' If toolBarButton1 in in the collection, remove it.
      If toolBar.Buttons.Contains(toolBarButton1) Then
         toolBar.Buttons.Remove(toolBarButton1)
      End If

      ' Create three toolbar buttons.
      Dim tbb1 As New ToolBarButton("tbb1")
      Dim tbb2 As New ToolBarButton("tbb2")
      Dim tbb3 As New ToolBarButton("tbb3")

      ' Add toolbar buttons to the toolbar.		
      toolBar.Buttons.AddRange(New ToolBarButton() {tbb2, tbb3})
      toolBar.Buttons.Add("tbb4")

      ' Insert tbb1 into the first position in the collection.
      toolBar.Buttons.Insert(0, tbb1)
   End If
End Sub

注解

ToolBarButton数组中包含的对象 nodes 将追加到集合的末尾。The ToolBarButton objects contained in the nodes array are appended to the end of the collection.

可以使用方法将一组以前创建的对象快速添加 ToolBarButton 到集合,而不是使用方法手动将它们添加 ToolBarButton 到集合中 AddYou can use method to quickly add a group of previously created ToolBarButton objects to the collection instead of manually adding each ToolBarButton to the collection using the Add method.

若要删除 ToolBarButton 先前添加的,请使用 Remove RemoveAtClear 方法。To remove a ToolBarButton that you have previously added, use the Remove, RemoveAt or Clear methods.

适用于

另请参阅