Form.ControlCollection Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
- 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. |