ToolBar.ToolBarButtonCollection.Add Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Dodaje nowy przycisk paska narzędzi na końcu kolekcji przycisków paska narzędzi.

Przeciążenia

Add(String)	Dodaje nowy przycisk paska narzędzi na końcu kolekcji przycisków paska narzędzi z określoną Text wartością właściwości.
Add(ToolBarButton)	Dodaje określony przycisk paska narzędzi na końcu kolekcji przycisków paska narzędzi.

Add(String)

Dodaje nowy przycisk paska narzędzi na końcu kolekcji przycisków paska narzędzi z określoną Text wartością właściwości.

public:
 int Add(System::String ^ text);

public int Add (string text);

member this.Add : string -> int

Public Function Add (text As String) As Integer

Parametry

text

String

Tekst do wyświetlenia w nowym ToolBarButtonobiekcie .

Zwraca

Int32

Wartość indeksu ToolBarButton oparta na zera dodana do kolekcji.

Przykłady

Poniższy przykład kodu usuwa istniejący ToolBarButton element z kontrolki ToolBar , jeśli istnieje, i dodaje i wstawia cztery nowe ToolBarButton obiekty do obiektu ToolBar. W tym przykładzie wymagane jest posiadanie Form kontrolki z kontrolką ToolBar .

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

Uwagi

Możesz również dodać nowe ToolBarButton obiekty do kolekcji przy użyciu AddRange metod lub Insert lub innej Add wersji metody.

Aby usunąć ToolBarButton element, który został wcześniej dodany, użyj Removemetod lub RemoveAt Clear .

Zobacz też

• Remove(ToolBarButton)
• Clear()

Add(ToolBarButton)

Dodaje określony przycisk paska narzędzi na końcu kolekcji przycisków paska narzędzi.

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

Parametry

button

ToolBarButton

Element do dodania ToolBarButton po wszystkich istniejących przyciskach.

Zwraca

Int32

Wartość indeksu ToolBarButton oparta na zera dodana do kolekcji.

Przykłady

Poniższy przykład kodu dodaje nową ToolBarButton kontrolkę do istniejącej ToolBar z istniejącymi przyciskami. Przycisk paska narzędzi zostanie dodany na końcu kolekcji ToolBar.Buttons .

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

Uwagi

Możesz również dodać nowe ToolBarButton obiekty do kolekcji przy użyciu AddRange metod lub Insert lub innej Add wersji metody.

Aby usunąć ToolBarButton element, który został wcześniej dodany, użyj Removemetod lub RemoveAt Clear .

Zobacz też

• Remove(ToolBarButton)
• Clear()