Form.ControlCollection Classe
Definição
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 controles no formulário.
public: ref class Form::ControlCollection : System::Windows::Forms::Control::ControlCollectionpublic class Form.ControlCollection : System.Windows.Forms.Control.ControlCollection[System.Runtime.InteropServices.ComVisible(false)]
public class Form.ControlCollection : System.Windows.Forms.Control.ControlCollectiontype Form.ControlCollection = class
inherit Control.ControlCollection[<System.Runtime.InteropServices.ComVisible(false)>]
type Form.ControlCollection = class
inherit Control.ControlCollectionPublic Class Form.ControlCollection
Inherits Control.ControlCollection- Herança
- 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. |