Control.ControlCollection Classe

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.

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

Mais…

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 Panel Buttone 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.

Aplica-se a