ToolBar.ToolBarButtonCollection Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Encapsula uma coleção de controles ToolBarButton para uso pela classe ToolBar.

public: ref class ToolBar::ToolBarButtonCollection : System::Collections::IList

public class ToolBar.ToolBarButtonCollection : System.Collections.IList

type ToolBar.ToolBarButtonCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public Class ToolBar.ToolBarButtonCollection
Implements IList

Herança

Object

ToolBar.ToolBarButtonCollection

Implementações

ICollection IEnumerable IList

Exemplos

O exemplo de código a seguir cria e inicializa um ToolBar e três ToolBarButton controles. Os botões da barra de ferramentas são atribuídos à barra de ferramentas e a barra de ferramentas é adicionada ao formulário. Esse código requer que um Form já tenha sido criado.

public:
   void InitializeMyToolBar()
   {
      // Create and initialize the ToolBarButton controls and ToolBar.
      ToolBar^ toolBar1 = gcnew ToolBar;
      ToolBarButton^ toolBarButton1 = gcnew ToolBarButton;
      ToolBarButton^ toolBarButton2 = gcnew ToolBarButton;
      ToolBarButton^ toolBarButton3 = gcnew ToolBarButton;
      
      // Set the Text properties of the ToolBarButton controls.
      toolBarButton1->Text = "Open";
      toolBarButton2->Text = "Save";
      toolBarButton3->Text = "Print";
      
      // Add the ToolBarButton controls to the ToolBar.
      toolBar1->Buttons->Add( toolBarButton1 );
      toolBar1->Buttons->Add( toolBarButton2 );
      toolBar1->Buttons->Add( toolBarButton3 );
      
      // Add the ToolBar to the Form.
      Controls->Add( toolBar1 );
   }

public void InitializeMyToolBar()
 {
    // Create and initialize the ToolBarButton controls and ToolBar.
    ToolBar toolBar1 = new ToolBar();
    ToolBarButton toolBarButton1 = new ToolBarButton();
    ToolBarButton toolBarButton2 = new ToolBarButton();
    ToolBarButton toolBarButton3 = new ToolBarButton();
 
    // Set the Text properties of the ToolBarButton controls.
    toolBarButton1.Text = "Open";
    toolBarButton2.Text = "Save";
    toolBarButton3.Text = "Print";
 
    // Add the ToolBarButton controls to the ToolBar.
    toolBar1.Buttons.Add(toolBarButton1);
    toolBar1.Buttons.Add(toolBarButton2);
    toolBar1.Buttons.Add(toolBarButton3);
 
    // Add the ToolBar to the Form.
    Controls.Add(toolBar1);
 }

Public Sub InitializeMyToolBar()
    ' Create and initialize the ToolBarButton controls and ToolBar.
    Dim toolBar1 As New ToolBar()
    Dim toolBarButton1 As New ToolBarButton()
    Dim toolBarButton2 As New ToolBarButton()
    Dim toolBarButton3 As New ToolBarButton()
    
    ' Set the Text properties of the ToolBarButton controls.
    toolBarButton1.Text = "Open"
    toolBarButton2.Text = "Save"
    toolBarButton3.Text = "Print"
    
    ' Add the ToolBarButton controls to the ToolBar.
    toolBar1.Buttons.Add(toolBarButton1)
    toolBar1.Buttons.Add(toolBarButton2)
    toolBar1.Buttons.Add(toolBarButton3)
    
    ' Add the ToolBar to the Form.
    Controls.Add(toolBar1)
End Sub

Comentários

É ToolBar.ToolBarButtonCollection uma coleção indexada baseada em zero usada pela ToolBar classe para manter todos os ToolBarButton controles atribuídos à barra de ferramentas. Use o Add método para adicionar botões individuais e o Remove método para excluí-los. Chame o Clear método para remover todos os botões da coleção.

Construtores

ToolBar.ToolBarButtonCollection(ToolBar)

Inicializa uma nova instância da classe ToolBar.ToolBarButtonCollection e a atribui à barra de ferramentas especificada.

Propriedades

Count	Obtém o número de botões na coleção de botões de barra de ferramentas.
IsReadOnly	Obtém um valor que indica se a coleção é somente leitura.
Item[Int32]	Obtém ou define o botão de barra de ferramentas no local indexado especificado na coleção de botões de barra de ferramentas.
Item[String]	Obtém um ToolBarButton com a chave especificada da coleção.

Métodos

Add(String)	Adiciona um novo botão de barra de ferramentas ao final da coleção de botões de barra de ferramentas com o valor da propriedade Text especificado.
Add(ToolBarButton)	Adiciona o botão de barra de ferramentas especificado ao final da coleção de botões de barra de ferramentas.
AddRange(ToolBarButton[])	Adiciona uma coleção de botões de barra de ferramentas a esta coleção de botões de barra de ferramentas.
Clear()	Remove todos os botões da coleção de botões de barra de ferramentas.
Contains(ToolBarButton)	Determina se o botão de barra de ferramentas especificado é membro da coleção.
ContainsKey(String)	Determina se um ToolBarButton com a chave especificada está contido na coleção.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Retorna um enumerador que pode ser usado para iterar pela coleção de botões de barra de ferramentas.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(ToolBarButton)	Recupera o índice do botão de barra de ferramentas especificado na coleção.
IndexOfKey(String)	Recupera o índice da primeira ocorrência de um ToolBarButton com a chave especificada.
Insert(Int32, ToolBarButton)	Insere um botão de barra de ferramentas existente na coleção de botões de barra de ferramentas no local especificado.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Remove(ToolBarButton)	Remove um botão especificado da coleção de botões de barra de ferramentas.
RemoveAt(Int32)	Remove um botão especificado da coleção de botões de barra de ferramentas.
RemoveByKey(String)	Remove o ToolBarButton com a chave especificada da coleção.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)	Copia os elementos do ICollection para um Array, começando em um determinado índice Array.
ICollection.IsSynchronized	Obtém um valor que indica se o acesso à coleção é sincronizado (thread-safe).
ICollection.SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso à coleção de botões.
IList.Add(Object)	Adiciona o botão de barra de ferramentas especificado ao final da coleção de botões de barra de ferramentas.
IList.Contains(Object)	Determina se a coleção contém um valor específico.
IList.IndexOf(Object)	Determina o índice de um item específico na coleção.
IList.Insert(Int32, Object)	Insere um botão de barra de ferramentas existente na coleção de botões de barra de ferramentas no local especificado.
IList.IsFixedSize	Obtém um valor que indica se a coleção tem um tamanho fixo.
IList.Item[Int32]	Obtém ou define o item em um índice especificado.
IList.Remove(Object)	Remove a primeira ocorrência de um item da coleção.

Métodos de Extensão

Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Confira também

• ToolBar
• ToolBarButton