ToolBar.ToolBarButtonCollection.AddRange(ToolBarButton[]) Método

Definição

Adiciona uma coleção de botões de barra de ferramentas a esta coleção de botões de barra de ferramentas.

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())

Parâmetros

buttons
ToolBarButton[]

A coleção de controles ToolBarButton a serem adicionados a esta ToolBar.ToolBarButtonCollection contida em uma matriz.

Exemplos

O exemplo de código a seguir remove um existente ToolBarButton de um ToolBar controle se ele existir e adiciona e insere quatro novos ToolBarButton objetos ao ToolBar. Este exemplo exige que você tenha um Form ToolBar controle sobre ele.

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

Comentários

Os ToolBarButton objetos contidos na nodes matriz são acrescentados ao final da coleção.

Você pode usar o método para adicionar rapidamente um grupo de objetos criados ToolBarButton anteriormente à coleção em vez de adicionar manualmente cada ToolBarButton um à coleção usando o Add método.

Para remover um ToolBarButton que você adicionou anteriormente, use os Removemétodos ou Clear os RemoveAt métodos.

Aplica-se a

Confira também