ToolBar.ToolBarButtonCollection.Clear Método

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Remove todos os botões da coleção de botões de barra de ferramentas.

public:
 virtual void Clear();

public void Clear ();

abstract member Clear : unit -> unit
override this.Clear : unit -> unit

Public Sub Clear ()

Implementações

Clear()

Exemplos

O exemplo de código a seguir exibe o Count Buttons antes e depois que o Clear método é chamado. Esse código requer que um ToolBar com pelo menos um ToolBarButton tenha sido criado.

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

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

Comentários

O Clear método itera por meio da coleção e remove todos os botões da barra de ferramentas atribuídos ao ToolBar.ToolBarButtonCollection.

Para remover um botão de barra de ferramentas individual da coleção, use os métodos ou RemoveAt os Remove métodos.

Para adicionar novos ToolBarButton objetos à coleção, use os Addmétodos ou Insert os AddRange métodos.

Aplica-se a

Partilhar via