ToolBar.ToolBarButtonCollection.AddRange メソッド

  • [アーティクル]

ツール バー ボタンのコレクションをこのツール バー ボタン コレクションに追加します。

Public Sub AddRange( _
   ByVal buttons() As ToolBarButton _)
[C#]
public void AddRange(ToolBarButton[] buttons);
[C++]
public: void AddRange(ToolBarButton* buttons[]);
[JScript]
public function AddRange(
   buttons : ToolBarButton[]);

パラメータ

解説

nodes 配列に格納されている複数の ToolBarButton オブジェクトが、コレクションの末尾に追加されます。

このメソッドを使用すると、 Add メソッドを使用して個別の ToolBarButton を手動でコレクションに追加するのではなく、以前作成した ToolBarButton オブジェクトのグループをすばやくコレクションに追加できます。

以前追加した ToolBarButton を削除するには、 Remove メソッド、 RemoveAt メソッド、または Clear メソッドを使用します。

使用例

[Visual Basic, C#, C++] 存在する場合は ToolBar コントロールから既存の ToolBarButton を削除し、 ToolBar に新しい 4 つの ToolBarButton オブジェクトを追加して挿入する例を次に示します。この例は、 ToolBar コントロールが配置された Form があることを前提にしています。

 
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

[C#] 
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);
   }
}

[C++] 
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(S"tbb1");
            ToolBarButton* tbb2 = new ToolBarButton(S"tbb2");
            ToolBarButton* tbb3 = new ToolBarButton(S"tbb3");

            // Add toolbar buttons to the toolbar.
            ToolBarButton* buttons[] = {tbb2, tbb3};
            toolBar->Buttons->AddRange(buttons);
            toolBar->Buttons->Add(S"tbb4");

            // Insert tbb1 into the first position in the collection.
            toolBar->Buttons->Insert(0, tbb1);
        }
    }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

ToolBar.ToolBarButtonCollection クラス | ToolBar.ToolBarButtonCollection メンバ | System.Windows.Forms 名前空間 | Add | Clear