Form.ControlCollection Classe

Definição

Representa uma coleção de controles no formulário.

public: ref class Form::ControlCollection : System::Windows::Forms::Control::ControlCollection
public class Form.ControlCollection : System.Windows.Forms.Control.ControlCollection
[System.Runtime.InteropServices.ComVisible(false)]
public class Form.ControlCollection : System.Windows.Forms.Control.ControlCollection
type Form.ControlCollection = class
    inherit Control.ControlCollection
[<System.Runtime.InteropServices.ComVisible(false)>]
type Form.ControlCollection = class
    inherit Control.ControlCollection
Public Class Form.ControlCollection
Inherits Control.ControlCollection
Herança
Form.ControlCollection
Herança
Atributos

Exemplos

O exemplo de código a seguir adiciona um TextBox controle à Label coleção de controle de um formulário. O exemplo requer que um formulário tenha sido criado e nomeado Form1.

public:
   void AddMyControls()
   {
      TextBox^ textBox1 = gcnew TextBox;
      Label^ label1 = gcnew Label;
      
      // Initialize the controls and their bounds.
      label1->Text = "First Name";
      label1->Location = Point( 48, 48 );
      label1->Size = System::Drawing::Size( 104, 16 );
      textBox1->Text = "";
      textBox1->Location = Point(48,64);
      textBox1->Size = System::Drawing::Size( 104, 16 );
      
      // Add the TextBox control to the form's control collection.
      Controls->Add( textBox1 );
      // Add the Label control to the form's control collection.
      Controls->Add( label1 );
   }
public void AddMyControls()
 {
    TextBox textBox1 = new TextBox();
    Label label1 = new Label();
    
    // Initialize the controls and their bounds.
    label1.Text = "First Name";
    label1.Location = new Point(48,48);
    label1.Size = new Size (104, 16);
    textBox1.Text = "";
    textBox1.Location = new Point(48, 64);
    textBox1.Size = new Size(104,16);
 
    // Add the TextBox control to the form's control collection.
    Controls.Add(textBox1);
    // Add the Label control to the form's control collection.
    Controls.Add(label1);
 }
Public Sub AddMyControls()
    Dim textBox1 As New TextBox()
    Dim label1 As New Label()
    
    ' Initialize the controls and their bounds.
    label1.Text = "First Name"
    label1.Location = New Point(48, 48)
    label1.Size = New Size(104, 16)
    textBox1.Text = ""
    textBox1.Location = New Point(48, 64)
    textBox1.Size = New Size(104, 16)
    
    ' Add the TextBox control to the form's control collection.
    Controls.Add(textBox1)
    ' Add the Label control to the form's control collection.
    Controls.Add(label1)
End Sub

Comentários

Essa classe representa a coleção de controles contidos em um formulário. Você pode usar o Add método para adicionar um controle ao formulário e ao Remove método para remover o controle do formulário. A coleção de controle representada por essa classe não pode ser criada sem vinculá-la a um formulário específico. Como resultado, você não pode criar várias instâncias dessa coleção de controle e intercambiá-las com um formulário ativo para fornecer layouts de controle diferentes.

Construtores

Nome Description
Form.ControlCollection(Form)

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

Propriedades

Nome Description
Count

Obtém o número de elementos contidos na coleção.

(Herdado de Control.ControlCollection)
IsReadOnly

Obtém um valor que indica se esse objeto de coleção é somente leitura.

(Herdado de Control.ControlCollection)
Item[Int32]

Indica o Control local indexado especificado na coleção.

(Herdado de Control.ControlCollection)
Item[String]

Indica um Control com a chave especificada na coleção.

(Herdado de Control.ControlCollection)
Owner

Obtém o controle que é o proprietário disso Control.ControlCollection.

(Herdado de Control.ControlCollection)

Métodos

Nome Description
Add(Control)

Adiciona um controle ao formulário.

AddRange(Control[])

Adiciona uma matriz de objetos de controle à coleção.

(Herdado de Control.ControlCollection)
Clear()

Remove todos os controles da coleção.

(Herdado de Control.ControlCollection)
Contains(Control)

Determina se o controle especificado é um membro da coleção.

(Herdado de Control.ControlCollection)
ContainsKey(String)

Determina se ele Control.ControlCollection contém um item com a chave especificada.

(Herdado de Control.ControlCollection)
CopyTo(Array, Int32)

Copia os elementos da coleção para uma matriz, começando em um índice de matriz específico.

(Herdado de Control.ControlCollection)
Equals(Object)

Especifica se o objeto de coleção atual e o objeto especificado são iguais.

(Herdado de Control.ControlCollection)
Find(String, Boolean)

Pesquisa controles por sua Name propriedade e cria uma matriz de todos os controles que correspondem.

(Herdado de Control.ControlCollection)
GetChildIndex(Control, Boolean)

Recupera o índice do controle filho especificado dentro da coleção de controles e, opcionalmente, gera uma exceção se o controle especificado não estiver dentro da coleção de controle.

(Herdado de Control.ControlCollection)
GetChildIndex(Control)

Recupera o índice do controle filho especificado dentro da coleção de controle.

(Herdado de Control.ControlCollection)
GetEnumerator()

Recupera uma referência a um objeto enumerador que é usado para iterar em um Control.ControlCollection.

(Herdado de Control.ControlCollection)
GetHashCode()

Retorna o código hash dessa instância.

(Herdado de Control.ControlCollection)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IndexOf(Control)

Recupera o índice do controle especificado na coleção de controle.

(Herdado de Control.ControlCollection)
IndexOfKey(String)

Recupera o índice da primeira ocorrência do item especificado na coleção.

(Herdado de Control.ControlCollection)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
Remove(Control)

Remove um controle do formulário.

RemoveAt(Int32)

Remove um controle da coleção de controle no local indexado especificado.

(Herdado de Control.ControlCollection)
RemoveByKey(String)

Remove o controle filho com a chave especificada.

(Herdado de Control.ControlCollection)
SetChildIndex(Control, Int32)

Define o índice do controle filho especificado na coleção como o valor de índice especificado.

(Herdado de Control.ControlCollection)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Implantações explícitas de interface

Nome Description
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 deste membro, consulte Clone().

(Herdado de Control.ControlCollection)
ICollection.IsSynchronized

Para obter uma descrição desse membro, consulte a IsSynchronized propriedade.

(Herdado de ArrangedElementCollection)
ICollection.SyncRoot

Para obter uma descrição desse membro, consulte a SyncRoot propriedade.

(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 deste membro, consulte Add(Object).

(Herdado de Control.ControlCollection)
IList.Clear()

Para obter uma descrição desse membro, consulte o Clear() método.

(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 deste membro, consulte Contains(Object).

(Herdado de Control.ControlCollection)
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 deste membro, consulte IndexOf(Object).

(Herdado de Control.ControlCollection)
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 deste membro, consulte Insert(Int32, Object).

(Herdado de Control.ControlCollection)
IList.IsFixedSize

Para obter uma descrição desse membro, consulte a IsFixedSize propriedade.

(Herdado de ArrangedElementCollection)
IList.Item[Int32]

Para obter uma descrição desse membro, consulte a Item[Int32] propriedade.

(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 deste membro, consulte Remove(Object).

(Herdado de Control.ControlCollection)
IList.RemoveAt(Int32)

Para obter uma descrição desse membro, consulte o RemoveAt(Int32) método.

(Herdado de ArrangedElementCollection)

Métodos de Extensão

Nome Description
AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.

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.

Aplica-se a

Confira também