ToolBar.ToolBarButtonCollection.Add Método

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Adiciona um novo botão da barra de ferramentas ao final da coleção de botões da barra de ferramentas.

Sobrecargas

Name Description
Add(String)

Adiciona um novo botão de barra de ferramentas ao final da coleção de botões com o valor especificado Text da propriedade.
Add(ToolBarButton)

Adiciona o botão especificado da barra de ferramentas ao final da coleção de botões da barra de ferramentas.

Add(String)

Origem:
ToolBar.ToolBarButtonCollection.cs
Origem:
ToolBar.ToolBarButtonCollection.cs

Adiciona um novo botão de barra de ferramentas ao final da coleção de botões com o valor especificado Text da propriedade.

public:
 int Add(System::String ^ text);
public int Add(string text);
member this.Add : string -> int
Public Function Add (text As String) As Integer

Parâmetros

text
String

O texto para mostrar no novo ToolBarButton.

Devoluções

Int32

O valor ToolBarButton do índice baseado em zero da soma à coleção.

Exemplos

O exemplo de código seguinte remove um existente ToolBarButton de um ToolBar controlo se este existir e adiciona e insere quatro novos ToolBarButton objetos ao ToolBar. Este exemplo exige que tenhas um Form com um ToolBar controlo 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

Observações

Também pode adicionar novos ToolBarButton objetos à coleção usando os AddRange métodos ou Insert , ou a outra versão do Add método.

Para remover algo ToolBarButton que já adicionou anteriormente, use os Removemétodos , RemoveAt ou Clear .

Ver também

Aplica-se a

Add(ToolBarButton)

Origem:
ToolBar.ToolBarButtonCollection.cs
Origem:
ToolBar.ToolBarButtonCollection.cs

Adiciona o botão especificado da barra de ferramentas ao final da coleção de botões da barra de ferramentas.

public:
 int Add(System::Windows::Forms::ToolBarButton ^ button);
public int Add(System.Windows.Forms.ToolBarButton button);
member this.Add : System.Windows.Forms.ToolBarButton -> int
Public Function Add (button As ToolBarButton) As Integer

Parâmetros

button
ToolBarButton

O ToolBarButton a ser adicionado depois de todos os botões existentes.

Devoluções

Int32

O valor ToolBarButton do índice baseado em zero da soma à coleção.

Exemplos

O exemplo de código seguinte adiciona um novo ToolBarButton controlo a um existente ToolBar com botões existentes. O botão da barra de ferramentas será adicionado ao final da ToolBar.Buttons coleção.

public:
   void AddMyButton()
   {
      ToolBarButton^ toolBarButton1 = gcnew ToolBarButton;
      toolBarButton1->Text = "Print";
      
      // Add the new toolbar button to the toolbar.
      toolBar1->Buttons->Add( toolBarButton1 );
   }

public void AddMyButton()
 {
    ToolBarButton toolBarButton1 = new ToolBarButton();
    toolBarButton1.Text = "Print";
 
    // Add the new toolbar button to the toolbar.
    toolBar1.Buttons.Add(toolBarButton1);
 }

Public Sub AddMyButton()
    Dim toolBarButton1 As New ToolBarButton()
    toolBarButton1.Text = "Print"
    
    ' Add the new toolbar button to the toolbar.
    toolBar1.Buttons.Add(toolBarButton1)
End Sub

Observações

Também pode adicionar novos ToolBarButton objetos à coleção usando os AddRange métodos ou Insert , ou a outra versão do Add método.

Para remover algo ToolBarButton que já adicionou anteriormente, use os Removemétodos , RemoveAt ou Clear .

Ver também

Aplica-se a