Form.ControlCollection Clase

Definición

Representa una colección de controles en el formulario.Represents a collection of controls on the form.

public: ref 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
Public Class Form.ControlCollection
Inherits Control.ControlCollection
Herencia
Form.ControlCollection
Atributos

Ejemplos

En el ejemplo de código siguiente TextBox se Label agrega un control y a la colección de controles de un formulario.The following code example adds a TextBox and Label control to the control collection of a form. El ejemplo requiere que se haya creado un formulario y que Form1tenga el nombre.The example requires that a form has been created and named 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.This class represents the collection of controls contained within a form. Puede usar el Add método para agregar un control al formulario y el Remove método para quitar el control del formulario.You can use the Add method to add a control to the form and the Remove method to remove the control from the form. La colección de controles representada por esta clase no se puede crear sin enlazarla a un formulario específico.The control collection represented by this class cannot be created without binding it to a specific form. Como resultado, no se pueden crear varias instancias de esta colección de controles ni intercambiar con un formulario activo para proporcionar diseños de control diferentes.As a result, you cannot create multiple instances of this control collection and interchange them with an active form to provide different control layouts.

Constructores

Form.ControlCollection(Form)

Inicializa una nueva instancia de la clase Form.ControlCollection.Initializes a new instance of the Form.ControlCollection class.

Propiedades

Count

Obtiene el número de elementos contenido en la colección.Gets the number of elements contained in the collection.

(Heredado de Control.ControlCollection)
IsReadOnly

Obtiene un valor que indica si este objeto de colección es de solo lectura.Gets a value that indicates whether this collection object is read-only.

(Heredado de Control.ControlCollection)
Item[Int32]

Indica el objeto Control que se encuentra en la ubicación indizada especificada de la colección.Indicates the Control at the specified indexed location in the collection.

(Heredado de Control.ControlCollection)
Item[String]

Indica un objeto Control con la clave especificada de la colección.Indicates a Control with the specified key in the collection.

(Heredado de Control.ControlCollection)
Owner

Obtiene el control al que pertenece esta colección Control.ControlCollection.Gets the control that owns this Control.ControlCollection.

(Heredado de Control.ControlCollection)

Métodos

Add(Control)

Agrega un control al formulario.Adds a control to the form.

AddRange(Control[])

Agrega una matriz de objetos de control a la colección.Adds an array of control objects to the collection.

(Heredado de Control.ControlCollection)
Clear()

Quita todos los controles de la colección.Removes all controls from the collection.

(Heredado de Control.ControlCollection)
Contains(Control)

Determina si el objeto especificado es un miembro de la colección.Determines whether the specified control is a member of the collection.

(Heredado de Control.ControlCollection)
ContainsKey(String)

Determina si la colección Control.ControlCollection contiene un elemento con la clave especificada.Determines whether the Control.ControlCollection contains an item with the specified key.

(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.Copies the elements of the collection to an array, starting at a particular array index.

(Heredado de Control.ControlCollection)
Equals(Object)

Especifica si el objeto de la colección actual y el objeto especificado son iguales.Specifies whether the current collection object and the specified object are equal.

(Heredado de Control.ControlCollection)
Find(String, Boolean)

Busca los controles por su propiedad Name y crea una matriz de todos los controles que coinciden.Searches for controls by their Name property and builds an array of all the controls that match.

(Heredado de Control.ControlCollection)
GetChildIndex(Control)

Recupera el índice de un control secundario especificado de la colección de controles.Retrieves the index of the specified child control within the control collection.

(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.Retrieves the index of the specified child control within the control collection, and optionally raises an exception if the specified control is not within the control collection.

(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.Retrieves a reference to an enumerator object that is used to iterate over a Control.ControlCollection.

(Heredado de Control.ControlCollection)
GetHashCode()

Devuelve el código hash de esta instancia.Returns the hash code for this instance.

(Heredado de Control.ControlCollection)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
IndexOf(Control)

Recupera el índice del control especificado de la colección de controles.Retrieves the index of the specified control in the control collection.

(Heredado de Control.ControlCollection)
IndexOfKey(String)

Devuelve el índice de la primera aparición del elemento especificado en esta colección.Retrieves the index of the first occurrence of the specified item within the collection.

(Heredado de Control.ControlCollection)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
Remove(Control)

Quita un control del formulario.Removes a control from the form.

RemoveAt(Int32)

Quita un control de la colección de controles en la ubicación del índice especificada.Removes a control from the control collection at the specified indexed location.

(Heredado de Control.ControlCollection)
RemoveByKey(String)

Quita el control secundario con la clave especificada.Removes the child control with the specified key.

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

Establece el índice el control secundario especificado en la colección como el valor de índice especificado.Sets the index of the specified child control in the collection to the specified index value.

(Heredado de Control.ControlCollection)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

ICloneable.Clone()

Para obtener una descripción de este miembro, vea Clone().For a description of this member, see Clone().

(Heredado de Control.ControlCollection)
IList.Add(Object)

Para una descripción de este miembro, vea Add(Object).For a description of this member, see Add(Object).

(Heredado de Control.ControlCollection)
IList.Contains(Object)

Para obtener una descripción de este miembro, vea Contains(Object).For a description of this member, see Contains(Object).

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

Para obtener una descripción de este miembro, vea IndexOf(Object).For a description of this member, see IndexOf(Object).

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

Para una descripción de este miembro, vea Insert(Int32, Object).For a description of this member, see Insert(Int32, Object).

(Heredado de Control.ControlCollection)
IList.Remove(Object)

Para una descripción de este miembro, vea Remove(Object).For a description of this member, see Remove(Object).

(Heredado de Control.ControlCollection)

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a

Consulte también: