Control.ControlCollection Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Representa una colección de objetos Control.

public: ref class Control::ControlCollection : ICloneable, System::Collections::IList

public: ref class Control::ControlCollection : System::Windows::Forms::Layout::ArrangedElementCollection, ICloneable, System::Collections::IList

[System.ComponentModel.ListBindable(false)]
public class Control.ControlCollection : ICloneable, System.Collections.IList

[System.ComponentModel.ListBindable(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public class Control.ControlCollection : System.Windows.Forms.Layout.ArrangedElementCollection, ICloneable, System.Collections.IList

[System.ComponentModel.ListBindable(false)]
public class Control.ControlCollection : System.Windows.Forms.Layout.ArrangedElementCollection, ICloneable, System.Collections.IList

[<System.ComponentModel.ListBindable(false)>]
type Control.ControlCollection = class
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

[<System.ComponentModel.ListBindable(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
type Control.ControlCollection = class
    inherit ArrangedElementCollection
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

[<System.ComponentModel.ListBindable(false)>]
type Control.ControlCollection = class
    inherit ArrangedElementCollection
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

Public Class Control.ControlCollection
Implements ICloneable, IList

Public Class Control.ControlCollection
Inherits ArrangedElementCollection
Implements ICloneable, IList

Herencia

Object

Control.ControlCollection

Herencia

Object

ArrangedElementCollection

Control.ControlCollection

Derivado

System.Windows.Forms.DataGridView.DataGridViewControlCollection

System.Windows.Forms.Form.ControlCollection

System.Windows.Forms.MdiClient.ControlCollection

System.Windows.Forms.TabControl.ControlCollection

System.Windows.Forms.TableLayoutControlCollection

System.Windows.Forms.TabPage.TabPageControlCollection

Atributos

ListBindableAttribute ComVisibleAttribute

Implementaciones

ICollection IEnumerable IList ICloneable

Ejemplos

En el ejemplo de código siguiente se quita un Control elemento de de la Control.ControlCollection clase Panel derivada si es miembro de la colección. En el ejemplo se requiere que haya creado un Panelcontrol , y Buttonal menos un RadioButton control en .Form Los RadioButton controles se agregan al Panel control y el Panel control agregado a Form. Cuando se hace clic en el botón, el botón de radio denominado radioButton2 se quita de .Control.ControlCollection

   // Remove the RadioButton control if it exists.
private:
   void removeButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      if ( panel1->Controls->Contains( removeButton ) )
      {
         panel1->Controls->Remove( removeButton );
      }
   }

// Remove the RadioButton control if it exists.
private void removeButton_Click(object sender, System.EventArgs e)
{
   if(panel1.Controls.Contains(removeButton))
   {
      panel1.Controls.Remove(removeButton);
   }
}

' Remove the RadioButton control if it exists.
Private Sub RemoveButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles RemoveButton.Click
    If Panel1.Controls.Contains(RemoveButton) Then
        Panel1.Controls.Remove(RemoveButton)
    End If
End Sub

Comentarios

Los Addmétodos , Removey RemoveAt permiten agregar y quitar controles individuales de la colección. También puede usar los AddRange métodos o Clear para agregar o quitar todos los controles de la colección.

Puede determinar si es Control miembro de la colección pasando el control al Contains método . Para obtener el valor de índice de la ubicación de en Control la colección, pase el control al IndexOf método . La colección se puede copiar en una matriz llamando al CopyTo método .

Constructores

Control.ControlCollection(Control)

Inicializa una nueva instancia de la clase Control.ControlCollection.

Propiedades

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

Métodos

Add(Control)	Agrega el control especificado a la colección de controles.
AddRange(Control[])	Agrega una matriz de objetos de control a la colección.
Clear()	Quita todos los controles de la colección.
Contains(Control)	Determina si el objeto especificado es un miembro de la colección.
ContainsKey(String)	Determina si la colección Control.ControlCollection contiene un elemento con la clave especificada.
CopyTo(Array, Int32)	Copia los elementos de la colección en una matriz a partir de un índice de matriz concreto.
CopyTo(Array, Int32)	Copia todo el contenido de esta colección a una Array unidimensional compatible, empezando en el índice especificado de la matriz de destino. (Heredado de ArrangedElementCollection)
Equals(Object)	Especifica si el objeto de la colección actual y el objeto especificado son iguales.
Equals(Object)	Determina si dos instancias de ArrangedElementCollection son iguales. (Heredado de ArrangedElementCollection)
Find(String, Boolean)	Busca los controles por su propiedad Name y crea una matriz de todos los controles que coinciden.
GetChildIndex(Control)	Recupera el índice de un control secundario especificado de la colección de controles.
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.
GetEnumerator()	Recupera una referencia a un objeto del enumerador que se utiliza para recorrer en iteración la colección Control.ControlCollection.
GetHashCode()	Devuelve el código hash de esta instancia.
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de ArrangedElementCollection)
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.
IndexOfKey(String)	Devuelve el índice de la primera aparición del elemento especificado en esta colección.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Remove(Control)	Quita el control especificado de la colección de controles.
RemoveAt(Int32)	Quita un control de la colección de controles en la ubicación del índice especificada.
RemoveByKey(String)	Quita el control secundario con la clave especificada.
SetChildIndex(Control, Int32)	Establece el índice el control secundario especificado en la colección como el valor de índice especificado.
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().
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).
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).
IList.Contains(Object)	Para obtener una descripción de este miembro, vea el método Contains(Object). (Heredado de ArrangedElementCollection)
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).
IList.IndexOf(Object)	Para obtener una descripción de este miembro, vea el método IndexOf(Object). (Heredado de ArrangedElementCollection)
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).
IList.Insert(Int32, Object)	Para obtener una descripción de este miembro, vea el método Insert(Int32, Object). (Heredado de ArrangedElementCollection)
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).
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.

Consulte también

• Control
• IList