ToolBar.ToolBarButtonCollection.Add Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Araç çubuğu düğmesi koleksiyonunun sonuna yeni bir araç çubuğu düğmesi ekler.

Aşırı Yüklemeler

Add(String)	Belirtilen Text özellik değeriyle araç çubuğu düğmesi koleksiyonunun sonuna yeni bir araç çubuğu düğmesi ekler.
Add(ToolBarButton)	Belirtilen araç çubuğu düğmesini araç çubuğu düğmesi koleksiyonunun sonuna ekler.

Add(String)

Belirtilen Text özellik değeriyle araç çubuğu düğmesi koleksiyonunun sonuna yeni bir araç çubuğu düğmesi ekler.

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

public int Add (string text);

member this.Add : string -> int

Public Function Add (text As String) As Integer

Parametreler

text

String

Yeni ToolBarButtonüzerinde görüntülenecek metin.

Döndürülenler

Int32

Koleksiyonuna eklenen öğesinin ToolBarButton sıfır tabanlı dizin değeri.

Örnekler

Aşağıdaki kod örneği, varsa bir denetimden var olan ToolBarButton bir ToolBar nesneyi kaldırır ve öğesine dört yeni ToolBarButton nesne ToolBarekleyip ekler. Bu örnek, üzerinde bir denetimi olan bir Form ToolBar öğesinin olmasını gerektirir.

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

Açıklamalar

Veya yöntemlerini veya yöntemin diğer sürümünü Add kullanarak AddRange Insert koleksiyona yeni ToolBarButton nesneler de ekleyebilirsiniz.

Daha önce eklediğiniz bir ToolBarButton öğesini kaldırmak için , RemoveAt veya Clear yöntemlerini kullanınRemove.

Ayrıca bkz.

• Remove(ToolBarButton)
• Clear()

Add(ToolBarButton)

Belirtilen araç çubuğu düğmesini araç çubuğu düğmesi koleksiyonunun sonuna ekler.

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

Parametreler

button

ToolBarButton

ToolBarButton tüm mevcut düğmelerin ardından eklenecek.

Döndürülenler

Int32

Koleksiyonuna eklenen öğesinin ToolBarButton sıfır tabanlı dizin değeri.

Örnekler

Aşağıdaki kod örneği, mevcut düğmelerle var olan ToolBar bir denetime yeni ToolBarButton bir denetim ekler. Araç çubuğu düğmesi koleksiyonun sonuna ToolBar.Buttons eklenir.

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

Açıklamalar

Veya yöntemlerini veya yöntemin diğer sürümünü Add kullanarak AddRange Insert koleksiyona yeni ToolBarButton nesneler de ekleyebilirsiniz.

Daha önce eklediğiniz bir ToolBarButton öğesini kaldırmak için , RemoveAt veya Clear yöntemlerini kullanınRemove.

Ayrıca bkz.

• Remove(ToolBarButton)
• Clear()