ToolBar.ToolBarButtonCollection.Clear メソッド

.NET Framework クラス ライブラリ リファレンス

ToolBar.ToolBarButtonCollection.Clear メソッド

ツール バー ボタン コレクションからすべてのボタンを削除します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Sub Clear

Visual Basic (使用法)

Dim instance As ToolBarButtonCollection

instance.Clear

C#

public void Clear ()

C++

public:
virtual void Clear () sealed

J#

public final void Clear ()

JScript

public final function Clear ()

解説

Clear メソッドは、コレクションを反復処理して、ToolBar.ToolBarButtonCollection に割り当てられているすべてのツール バー ボタンを削除します。

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

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

使用例

Clear メソッドが呼び出される前後に Buttons の Count を表示するコード例を次に示します。このコードは、少なくとも 1 つの ToolBarButton を持つ ToolBar が作成されていることを前提にしています。

Visual Basic

Public Sub ClearMyToolBar()
    Dim btns As Integer
    ' Get the count before the Clear method is called.
    btns = toolBar1.Buttons.Count
    toolBar1.Buttons.Clear()
    MessageBox.Show("Count Before Clear: " + btns.ToString()
 & _
        Microsoft.VisualBasic.ControlChars.Cr & "Count After
 Clear: " & _
        toolBar1.Buttons.Count.ToString())
End Sub

C#

public void ClearMyToolBar()
 {
    int btns;
    // Get the count before the Clear method is called.
    btns = toolBar1.Buttons.Count;
    toolBar1.Buttons.Clear();
    MessageBox.Show("Count Before Clear: " + btns.ToString() +
                    "\nCount After Clear: " + toolBar1.Buttons.Count.ToString());
 }
 

C++

public:
   void ClearMyToolBar()
   {
      int btns;
      // Get the count before the Clear method is called.
      btns = toolBar1->Buttons->Count;
      toolBar1->Buttons->Clear();
      MessageBox::Show( "Count Before Clear: " + btns.ToString() +
         "\nCount After Clear: " + toolBar1->Buttons->Count.ToString()
 );
   }

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
ToolBar.ToolBarButtonCollection クラス
ToolBar.ToolBarButtonCollection メンバ
System.Windows.Forms 名前空間
Remove
ToolBarButton
Add
Item