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 e Label controle à 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

Form.ControlCollection(Form)

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

Propriedades

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 no 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 proprietário desse Control.ControlCollection.

(Herdado de Control.ControlCollection)

Métodos

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 é membro da coleção.

(Herdado de Control.ControlCollection)
ContainsKey(String)

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

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

Copia os elementos da coleção em 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 propriedade Name e cria uma matriz de todos os controles que correspondam.

(Herdado de Control.ControlCollection)
GetChildIndex(Control)

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

(Herdado de Control.ControlCollection)
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.

(Herdado de Control.ControlCollection)
GetEnumerator()

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

(Herdado de Control.ControlCollection)
GetHashCode()

Retorna o código hash para a 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 controles.

(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 Object atual.

(Herdado de Object)
Remove(Control)

Remove um controle do formulário.

RemoveAt(Int32)

Remove um controle da coleção de controles 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 com 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

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().

(Herdado de Control.ControlCollection)
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).

(Herdado de Control.ControlCollection)
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).

(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 desse membro, confira 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 desse membro, confira Insert(Int32, Object).

(Herdado de Control.ControlCollection)
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).

(Herdado de Control.ControlCollection)
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

Confira também