ToolBar.ToolBarButtonCollection.Clear 方法

从工具栏按钮集合中移除所有按钮。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
Public Sub Clear
用法
Dim instance As ToolBarButtonCollection

instance.Clear

public void Clear ()

public:
virtual void Clear () sealed

public final void Clear ()

public final function Clear ()

备注

Clear 方法循环访问集合，并移除分配给 ToolBar.ToolBarButtonCollection 的所有工具栏按钮。

若要从集合中移除单个工具栏按钮，请使用 Remove 或 RemoveAt 方法。

若要向集合中添加新的 ToolBarButton 对象，请使用 Add、AddRange 或 Insert 方法。

示例

下面的代码示例显示在调用 Clear 方法之前和之后 Buttons 的 Count。这段代码要求已创建一个至少具有一个 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

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());
 }
 

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