Form.ControlCollection Classe

Definição

Representa um conjunto de controlos sobre o 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 seguinte exemplo de código adiciona um TextBox e Label controlo à coleção de controlos de um formulário. O exemplo exige que uma forma tenha sido criada e nomeada 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

Observações

Esta classe representa o conjunto de controlos contidos num formulário. Pode usar o Add método para adicionar um controlo ao formulário e o Remove método para remover o controlo do formulário. A coleção de controlo representada por esta classe não pode ser criada sem a vincular a uma forma específica. Como resultado, não pode criar múltiplas instâncias desta coleção de controlos e trocá-las com uma forma ativa para fornecer diferentes layouts de controlo.

Construtores

Name Description
Form.ControlCollection(Form)

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

Propriedades

Name Description
Count

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

(Herdado de Control.ControlCollection)
IsReadOnly

Recebe um valor que indica se este objeto de coleção é apenas de leitura.

(Herdado de Control.ControlCollection)
Item[Int32]

Indica o Control na localização indexada especificada na coleção.

(Herdado de Control.ControlCollection)
Item[String]

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

(Herdado de Control.ControlCollection)
Owner

Fica com o controlo que detém isto Control.ControlCollection.

(Herdado de Control.ControlCollection)

Métodos

Name Description
Add(Control)

Adiciona um controlo à forma.

AddRange(Control[])

Adiciona um conjunto de objetos de controlo à coleção.

(Herdado de Control.ControlCollection)
Clear()

Remove todos os controlos da coleção.

(Herdado de Control.ControlCollection)
Contains(Control)

Determina se o controlo especificado é membro da coleção.

(Herdado de Control.ControlCollection)
ContainsKey(String)

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

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

Copia os elementos da coleção para um array, começando num índice particular do array.

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

Procura controlos pela sua Name propriedade e constrói um conjunto de todos os controlos que correspondem.

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

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

(Herdado de Control.ControlCollection)
GetChildIndex(Control)

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

(Herdado de Control.ControlCollection)
GetEnumerator()

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

(Herdado de Control.ControlCollection)
GetHashCode()

Devolve o código de hash para esta instância.

(Herdado de Control.ControlCollection)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IndexOf(Control)

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

(Herdado de Control.ControlCollection)
IndexOfKey(String)

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

(Herdado de Control.ControlCollection)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Remove(Control)

Remove um controlo do formulário.

RemoveAt(Int32)

Remove um controlo da coleção de controlo na localização indexada especificada.

(Herdado de Control.ControlCollection)
RemoveByKey(String)

Remove o controlo filho com a chave especificada.

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

Define o índice do controlo filho especificado na coleção para o valor do índice especificado.

(Herdado de Control.ControlCollection)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Implementações de Interface Explícita

Name Description
ICloneable.Clone()

Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código.

Para uma descrição deste elemento, veja Clone().

(Herdado de Control.ControlCollection)
ICollection.IsSynchronized

Para uma descrição deste membro, veja a propriedade IsSynchronized .

(Herdado de ArrangedElementCollection)
ICollection.SyncRoot

Para uma descrição deste membro, veja a propriedade SyncRoot .

(Herdado de ArrangedElementCollection)
IList.Add(Object)

Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código.

Para uma descrição deste elemento, veja Add(Object).

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

Para uma descrição deste elemento, veja o Clear() método.

(Herdado de ArrangedElementCollection)
IList.Contains(Object)

Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código.

Para uma descrição deste elemento, veja Contains(Object).

(Herdado de Control.ControlCollection)
IList.IndexOf(Object)

Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código.

Para uma descrição deste elemento, veja IndexOf(Object).

(Herdado de Control.ControlCollection)
IList.Insert(Int32, Object)

Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código.

Para uma descrição deste elemento, veja Insert(Int32, Object).

(Herdado de Control.ControlCollection)
IList.IsFixedSize

Para uma descrição deste membro, veja a propriedade IsFixedSize .

(Herdado de ArrangedElementCollection)
IList.Item[Int32]

Para uma descrição deste membro, veja a propriedade Item[Int32] .

(Herdado de ArrangedElementCollection)
IList.Remove(Object)

Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código.

Para uma descrição deste elemento, veja Remove(Object).

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

Para uma descrição deste elemento, veja o RemoveAt(Int32) método.

(Herdado de ArrangedElementCollection)

Métodos da Extensão

Name Description
AsParallel(IEnumerable)

Permite a paralelização de uma consulta.

AsQueryable(IEnumerable)

Converte um IEnumerable para um IQueryable.

Cast<TResult>(IEnumerable)

Conjura os elementos de an IEnumerable para o tipo especificado.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base num tipo especificado.

Aplica-se a

Ver também