Form.ControlCollection Clase

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa una colección de controles en el formulario.

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

Herencia: Object

Control.ControlCollection
Form.ControlCollection

Herencia: Object

ArrangedElementCollection

Control.ControlCollection
Form.ControlCollection

Atributos: ComVisibleAttribute

Ejemplos

En el ejemplo de código siguiente se agrega un TextBox control y Label a la colección de controles de un formulario. El ejemplo requiere que se haya creado un formulario y se haya denominado 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

Comentarios

Esta clase representa la colección de controles contenidos en un formulario. Puede usar el Add método para agregar un control al formulario y el Remove método para quitar el control del formulario. La colección de controles representada por esta clase no se puede crear sin enlazarla a un formulario específico. Como resultado, no puede crear varias instancias de esta colección de controles e intercambiarlas con un formulario activo para proporcionar diseños de control diferentes.

Constructores

Form.ControlCollection(Form)

Inicializa una nueva instancia de la clase Form.ControlCollection.

Propiedades

Count	Obtiene el número de elementos contenido en la colección. (Heredado de Control.ControlCollection)
IsReadOnly	Obtiene un valor que indica si este objeto de colección es de solo lectura. (Heredado de Control.ControlCollection)
Item[Int32]	Indica el objeto Control que se encuentra en la ubicación indizada especificada de la colección. (Heredado de Control.ControlCollection)
Item[String]	Indica un objeto Control con la clave especificada de la colección. (Heredado de Control.ControlCollection)
Owner	Obtiene el control al que pertenece esta colección Control.ControlCollection. (Heredado de Control.ControlCollection)

Métodos

Add(Control)	Agrega un control al formulario.
AddRange(Control[])	Agrega una matriz de objetos de control a la colección. (Heredado de Control.ControlCollection)
Clear()	Quita todos los controles de la colección. (Heredado de Control.ControlCollection)
Contains(Control)	Determina si el objeto especificado es un miembro de la colección. (Heredado de Control.ControlCollection)
ContainsKey(String)	Determina si la colección Control.ControlCollection contiene un elemento con la clave especificada. (Heredado de Control.ControlCollection)
CopyTo(Array, Int32)	Copia los elementos de la colección en una matriz a partir de un índice de matriz concreto. (Heredado de Control.ControlCollection)
Equals(Object)	Especifica si el objeto de la colección actual y el objeto especificado son iguales. (Heredado de Control.ControlCollection)
Find(String, Boolean)	Busca los controles por su propiedad Name y crea una matriz de todos los controles que coinciden. (Heredado de Control.ControlCollection)
GetChildIndex(Control)	Recupera el índice de un control secundario especificado de la colección de controles. (Heredado de Control.ControlCollection)
GetChildIndex(Control, Boolean)	Recupera el índice del control secundario especificado en la colección de controles y, opcionalmente, provoca una excepción si el control especificado no está en la colección de controles. (Heredado de Control.ControlCollection)
GetEnumerator()	Recupera una referencia a un objeto del enumerador que se utiliza para recorrer en iteración la colección Control.ControlCollection. (Heredado de Control.ControlCollection)
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de Control.ControlCollection)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IndexOf(Control)	Recupera el índice del control especificado de la colección de controles. (Heredado de Control.ControlCollection)
IndexOfKey(String)	Devuelve el índice de la primera aparición del elemento especificado en esta colección. (Heredado de Control.ControlCollection)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Remove(Control)	Quita un control del formulario.
RemoveAt(Int32)	Quita un control de la colección de controles en la ubicación del índice especificada. (Heredado de Control.ControlCollection)
RemoveByKey(String)	Quita el control secundario con la clave especificada. (Heredado de Control.ControlCollection)
SetChildIndex(Control, Int32)	Establece el índice el control secundario especificado en la colección como el valor de índice especificado. (Heredado de Control.ControlCollection)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

ICloneable.Clone()	Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código. Para obtener una descripción de este miembro, vea Clone(). (Heredado de Control.ControlCollection)
ICollection.IsSynchronized	Para una descripción de este miembro, consulte la propiedad IsSynchronized. (Heredado de ArrangedElementCollection)
ICollection.SyncRoot	Para una descripción de este miembro, consulte la propiedad SyncRoot. (Heredado de ArrangedElementCollection)
IList.Add(Object)	Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código. Para obtener una descripción de este miembro, vea Add(Object). (Heredado de Control.ControlCollection)
IList.Clear()	Para obtener una descripción de este miembro, vea el método Clear(). (Heredado de ArrangedElementCollection)
IList.Contains(Object)	Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código. Para obtener una descripción de este miembro, vea Contains(Object). (Heredado de Control.ControlCollection)
IList.IndexOf(Object)	Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código. Para obtener una descripción de este miembro, vea IndexOf(Object). (Heredado de Control.ControlCollection)
IList.Insert(Int32, Object)	Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código. Para obtener una descripción de este miembro, vea Insert(Int32, Object). (Heredado de Control.ControlCollection)
IList.IsFixedSize	Para una descripción de este miembro, consulte la propiedad IsFixedSize. (Heredado de ArrangedElementCollection)
IList.Item[Int32]	Para una descripción de este miembro, consulte la propiedad Item[Int32]. (Heredado de ArrangedElementCollection)
IList.Remove(Object)	Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código. Para obtener una descripción de este miembro, vea Remove(Object). (Heredado de Control.ControlCollection)
IList.RemoveAt(Int32)	Para obtener una descripción de este miembro, vea el método RemoveAt(Int32). (Heredado de ArrangedElementCollection)

Métodos de extensión

Cast<TResult>(IEnumerable)	Convierte los elementos de IEnumerable en el tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de IEnumerable en función de un tipo especificado.
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte una interfaz IEnumerable en IQueryable.

Se aplica a

Consulte también

Control.ControlCollection

Compartir vía