ToolBar.ToolBarButtonCollection.Remove メソッド

ツール バー ボタン コレクションから指定したボタンを削除します。

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

パラメータ

• button
  コレクションから削除する ToolBarButton 。

解説

コレクションからツール バー ボタンを削除するには、 RemoveAt メソッドまたは Clear メソッドを使用します。

新しい ToolBarButton オブジェクトをコレクションに追加するには、 Add メソッド、 AddRange メソッド、または Insert メソッドを使用します。

使用例

[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 ファミリ, .NET Compact Framework - Windows CE .NET

参照

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