Control.ControlCollection Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Representa uma coleção de objetos Control .

public: ref class Control::ControlCollection : ICloneable, System::Collections::IList

public: ref class Control::ControlCollection : System::Windows::Forms::Layout::ArrangedElementCollection, ICloneable, System::Collections::IList

[System.ComponentModel.ListBindable(false)]
public class Control.ControlCollection : ICloneable, System.Collections.IList

[System.ComponentModel.ListBindable(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public class Control.ControlCollection : System.Windows.Forms.Layout.ArrangedElementCollection, ICloneable, System.Collections.IList

[System.ComponentModel.ListBindable(false)]
public class Control.ControlCollection : System.Windows.Forms.Layout.ArrangedElementCollection, ICloneable, System.Collections.IList

[<System.ComponentModel.ListBindable(false)>]
type Control.ControlCollection = class
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

[<System.ComponentModel.ListBindable(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
type Control.ControlCollection = class
    inherit ArrangedElementCollection
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

[<System.ComponentModel.ListBindable(false)>]
type Control.ControlCollection = class
    inherit ArrangedElementCollection
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

Public Class Control.ControlCollection
Implements ICloneable, IList

Public Class Control.ControlCollection
Inherits ArrangedElementCollection
Implements ICloneable, IList

Herança

Object

Control.ControlCollection

Herança

Object

ArrangedElementCollection

Control.ControlCollection

Derivado

System.Windows.Forms.DataGridView.DataGridViewControlCollection

System.Windows.Forms.Form.ControlCollection

System.Windows.Forms.MdiClient.ControlCollection

System.Windows.Forms.TabControl.ControlCollection

System.Windows.Forms.TableLayoutControlCollection

System.Windows.Forms.TabPage.TabPageControlCollection

Atributos

ListBindableAttribute ComVisibleAttribute

Implementações

ICollection IEnumerable IList ICloneable

Exemplos

O exemplo de código a Control.ControlCollection seguir remove um Control da classe Panel derivada se ele for um membro da coleção. O exemplo requer que você tenha criado um, um PanelButtone pelo menos um RadioButton controle em um Form. Os RadioButton controles são adicionados ao Panel controle e o Panel controle adicionado ao Form. Quando o botão é clicado, o botão de opção nomeado radioButton2 é removido do Control.ControlCollection.

   // Remove the RadioButton control if it exists.
private:
   void removeButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      if ( panel1->Controls->Contains( removeButton ) )
      {
         panel1->Controls->Remove( removeButton );
      }
   }

// Remove the RadioButton control if it exists.
private void removeButton_Click(object sender, System.EventArgs e)
{
   if(panel1.Controls.Contains(removeButton))
   {
      panel1.Controls.Remove(removeButton);
   }
}

' Remove the RadioButton control if it exists.
Private Sub RemoveButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles RemoveButton.Click
    If Panel1.Controls.Contains(RemoveButton) Then
        Panel1.Controls.Remove(RemoveButton)
    End If
End Sub

Comentários

Os Addmétodos e RemoveAt os Removemétodos permitem adicionar e remover controles individuais da coleção. Você também pode usar os AddRange métodos ou Clear adicionar ou remover todos os controles da coleção.

Você pode determinar se um Control é um membro da coleção passando o controle para o Contains método. Para obter o valor do índice da localização de um Control na coleção, passe o controle para o IndexOf método. A coleção pode ser copiada em uma matriz chamando o CopyTo método.

Construtores

Control.ControlCollection(Control)

Inicializa uma nova instância da classe Control.ControlCollection.

Propriedades

Count	Obtém o número de elementos contidos na coleção.
Count	Obtém o número de elementos na coleção. (Herdado de ArrangedElementCollection)
IsReadOnly	Obtém um valor que indica se esse objeto de coleção é somente leitura.
IsReadOnly	Obtém um valor que indica se a coleção é somente leitura. (Herdado de ArrangedElementCollection)
Item[Int32]	Indica o Control no local indexado especificado na coleção.
Item[String]	Indica um Control com a chave especificada na coleção.
Owner	Obtém o controle proprietário desse Control.ControlCollection.

Métodos

Add(Control)	Adiciona o controle especificado à coleção de controle.
AddRange(Control[])	Adiciona uma matriz de objetos de controle à coleção.
Clear()	Remove todos os controles da coleção.
Contains(Control)	Determina se o controle especificado é membro da coleção.
ContainsKey(String)	Determina se o Control.ControlCollection atual contém um item com a chave especificada.
CopyTo(Array, Int32)	Copia os elementos da coleção em uma matriz, começando em um índice de matriz específico.
CopyTo(Array, Int32)	Copia todo o conteúdo dessa coleção para um Array unidimensional compatível, começando pelo índice especificado da matriz de destino. (Herdado de ArrangedElementCollection)
Equals(Object)	Especifica se o objeto de coleção atual e o objeto especificado são iguais.
Equals(Object)	Determina se duas instâncias ArrangedElementCollection são iguais. (Herdado de ArrangedElementCollection)
Find(String, Boolean)	Pesquisa controles por sua propriedade Name e cria uma matriz de todos os controles que correspondam.
GetChildIndex(Control)	Recupera o índice do controle filho especificado na coleção de controles.
GetChildIndex(Control, Boolean)	Recupera o índice do controle filho especificado dentro da coleção de controle e, opcionalmente, gera uma exceção se o controle especificado não estiver dentro da coleção de controle.
GetEnumerator()	Recupera uma referência a um objeto de enumerador que é usado para iterar sobre uma Control.ControlCollection.
GetHashCode()	Retorna o código hash para a instância.
GetHashCode()	Retorna o código hash para a instância. (Herdado de ArrangedElementCollection)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(Control)	Recupera o índice do controle especificado na coleção de controles.
IndexOfKey(String)	Recupera o índice da primeira ocorrência do item especificado na coleção.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Remove(Control)	Remove o controle especificado da coleção do controle.
RemoveAt(Int32)	Remove um controle da coleção de controles no local indexado especificado.
RemoveByKey(String)	Remove o controle filho com a chave especificada.
SetChildIndex(Control, Int32)	Define o índice do controle filho especificado na coleção com o valor de índice especificado.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

ICloneable.Clone()	Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código. Para obter uma descrição desse membro, confira Clone().
ICollection.IsSynchronized	Para obter uma descrição desse membro, consulte o propriedade IsSynchronized. (Herdado de ArrangedElementCollection)
ICollection.SyncRoot	Para obter uma descrição desse membro, consulte o propriedade SyncRoot. (Herdado de ArrangedElementCollection)
IList.Add(Object)	Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código. Para obter uma descrição desse membro, confira Add(Object).
IList.Clear()	Para obter uma descrição desse membro, consulte o método Clear(). (Herdado de ArrangedElementCollection)
IList.Contains(Object)	Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código. Para obter uma descrição desse membro, confira Contains(Object).
IList.Contains(Object)	Para obter uma descrição desse membro, consulte o método Contains(Object). (Herdado de ArrangedElementCollection)
IList.IndexOf(Object)	Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código. Para obter uma descrição desse membro, confira IndexOf(Object).
IList.IndexOf(Object)	Para obter uma descrição desse membro, consulte o método IndexOf(Object). (Herdado de ArrangedElementCollection)
IList.Insert(Int32, Object)	Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código. Para obter uma descrição desse membro, confira Insert(Int32, Object).
IList.Insert(Int32, Object)	Para obter uma descrição desse membro, consulte o método Insert(Int32, Object). (Herdado de ArrangedElementCollection)
IList.IsFixedSize	Para obter uma descrição desse membro, consulte o propriedade IsFixedSize. (Herdado de ArrangedElementCollection)
IList.Item[Int32]	Para obter uma descrição desse membro, consulte o propriedade Item[Int32]. (Herdado de ArrangedElementCollection)
IList.Remove(Object)	Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código. Para obter uma descrição desse membro, confira Remove(Object).
IList.RemoveAt(Int32)	Para obter uma descrição desse membro, consulte o método RemoveAt(Int32). (Herdado de ArrangedElementCollection)

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

• Control
• IList