Control.ControlCollection Classe

Definição

Representa uma coleção de objetos Control .Represents a collection of Control objects.

public: ref class Control::ControlCollection : System::Windows::Forms::Layout::ArrangedElementCollection, 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
type Control.ControlCollection = class
    inherit ArrangedElementCollection
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable
Public Class Control.ControlCollection
Inherits ArrangedElementCollection
Implements ICloneable, IList
Herança
Control.ControlCollection
Derivado
Atributos
Implementações

Exemplos

O exemplo de código a seguir remove um Control do Control.ControlCollection da classe derivada Panel se for um membro da coleção.The following code example removes a Control from the Control.ControlCollection of the derived class Panel if it is a member of the collection. O exemplo requer que você tenha criado um Panel, um Button e pelo menos um controle RadioButton em um Form.The example requires that you have created a Panel, a Button, and at least one RadioButton control on a Form. Os controles RadioButton são adicionados ao controle Panel e o controle Panel adicionado ao Form.The RadioButton controls are added to the Panel control, and the Panel control added to the Form. Quando o botão é clicado, o botão de opção chamado radioButton2 é removido do Control.ControlCollection.When the button is clicked, the radio button named radioButton2 is removed from the 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 métodos Add, Remove e RemoveAt permitem adicionar e remover controles individuais da coleção.The Add, Remove, and RemoveAt methods enable you to add and remove individual controls from the collection. Você também pode usar os métodos AddRange ou Clear para adicionar ou remover todos os controles da coleção.You can also use the AddRange or Clear methods to add or remove all the controls from the collection.

Você pode determinar se um Control é um membro da coleção passando o controle para o método Contains.You can determine if a Control is a member of the collection by passing the control into the Contains method. Para obter o valor de índice do local de um Control na coleção, passe o controle para o método IndexOf.To get the index value of the location of a Control in the collection, pass the control into the IndexOf method. A coleção pode ser copiada em uma matriz chamando o método CopyTo.The collection can be copied into an array by calling the CopyTo method.

Construtores

Control.ControlCollection(Control)

Inicializa uma nova instância da classe Control.ControlCollection.Initializes a new instance of the Control.ControlCollection class.

Propriedades

Count

Obtém o número de elementos contidos na coleção.Gets the number of elements contained in the collection.

IsReadOnly

Obtém um valor que indica se esse objeto de coleção é somente leitura.Gets a value that indicates whether this collection object is read-only.

Item[Int32]

Indica o Control no local indexado especificado na coleção.Indicates the Control at the specified indexed location in the collection.

Item[String]

Indica um Control com a chave especificada na coleção.Indicates a Control with the specified key in the collection.

Owner

Obtém o controle proprietário desse Control.ControlCollection.Gets the control that owns this Control.ControlCollection.

Métodos

Add(Control)

Adiciona o controle especificado à coleção de controle.Adds the specified control to the control collection.

AddRange(Control[])

Adiciona uma matriz de objetos de controle à coleção.Adds an array of control objects to the collection.

Clear()

Remove todos os controles da coleção.Removes all controls from the collection.

Contains(Control)

Determina se o controle especificado é membro da coleção.Determines whether the specified control is a member of the collection.

ContainsKey(String)

Determina se o Control.ControlCollection atual contém um item com a chave especificada.Determines whether the Control.ControlCollection contains an item with the specified key.

CopyTo(Array, Int32)

Copia os elementos da coleção em uma matriz, começando em um índice de matriz específico.Copies the elements of the collection to an array, starting at a particular array index.

Equals(Object)

Especifica se o objeto de coleção atual e o objeto especificado são iguais.Specifies whether the current collection object and the specified object are equal.

Find(String, Boolean)

Pesquisa controles por sua propriedade Name e cria uma matriz de todos os controles que correspondam.Searches for controls by their Name property and builds an array of all the controls that match.

GetChildIndex(Control)

Recupera o índice do controle filho especificado na coleção de controles.Retrieves the index of the specified child control within the control collection.

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.Retrieves the index of the specified child control within the control collection, and optionally raises an exception if the specified control is not within the control collection.

GetEnumerator()

Recupera uma referência a um objeto de enumerador que é usado para iterar sobre uma Control.ControlCollection.Retrieves a reference to an enumerator object that is used to iterate over a Control.ControlCollection.

GetHashCode()

Retorna o código hash para essa instância.Returns the hash code for this instance.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
IndexOf(Control)

Recupera o índice do controle especificado na coleção de controles.Retrieves the index of the specified control in the control collection.

IndexOfKey(String)

Recupera o índice da primeira ocorrência do item especificado na coleção.Retrieves the index of the first occurrence of the specified item within the collection.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
Remove(Control)

Remove o controle especificado da coleção do controle.Removes the specified control from the control collection.

RemoveAt(Int32)

Remove um controle da coleção de controles no local indexado especificado.Removes a control from the control collection at the specified indexed location.

RemoveByKey(String)

Remove o controle filho com a chave especificada.Removes the child control with the specified key.

SetChildIndex(Control, Int32)

Define o índice do controle filho especificado na coleção com o valor de índice especificado.Sets the index of the specified child control in the collection to the specified index value.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Implantações explícitas de interface

ICloneable.Clone()

Para obter uma descrição desse membro, consulte Clone().For a description of this member, see Clone().

IList.Add(Object)

Para obter uma descrição desse membro, consulte Add(Object).For a description of this member, see Add(Object).

IList.Contains(Object)

Para obter uma descrição desse membro, consulte Contains(Object).For a description of this member, see Contains(Object).

IList.IndexOf(Object)

Para obter uma descrição desse membro, consulte IndexOf(Object).For a description of this member, see IndexOf(Object).

IList.Insert(Int32, Object)

Para obter uma descrição desse membro, consulte Insert(Int32, Object).For a description of this member, see Insert(Int32, Object).

IList.Remove(Object)

Para obter uma descrição desse membro, consulte Remove(Object).For a description of this member, see Remove(Object).

Métodos de Extensão

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a

Veja também