ToolBar.ToolBarButtonCollection.Clear メソッド

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

Public Overridable Sub Clear() Implements IList.Clear
[C#]
public virtual void Clear();
[C++]
public: virtual void Clear();
[JScript]
public function Clear();

実装

IList.Clear

解説

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

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

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

使用例

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

 
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(String::Format( S"Count Before Clear: {0}\nCount After Clear: {1}",
       __box(btns), __box(toolBar1->Buttons->Count)));
 }
 

[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 名前空間 | Remove | ToolBarButton | Add | Item