Control.ControlCollection Clase

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll
Source:
Control.ControlCollection.cs
Source:
Control.ControlCollection.cs
Source:
Control.ControlCollection.cs
Source:
Control.ControlCollection.cs
Source:
Control.ControlCollection.cs

Representa una colección de Control objetos.

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
Atributos
ListBindableAttribute ComVisibleAttribute
Implementaciones
ICollection IEnumerable IList ICloneable

Ejemplos

En el ejemplo de código siguiente se quita un Control elemento de Control.ControlCollection de la 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 se agrega 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 Control es 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

Nombre Description
Control.ControlCollection(Control)

Inicializa una nueva instancia de la clase Control.ControlCollection.

Propiedades

Nombre Description
Count

Obtiene el número de elementos contenidos 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 en Control la ubicación indizada especificada de la colección.
Item[String]

Indica una Control clase con la clave especificada en la colección.
Owner

Obtiene el control que posee este Control.ControlCollectionobjeto .

Métodos

Nombre Description
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 control especificado es miembro de la colección.
ContainsKey(String)

Determina si contiene Control.ControlCollection un elemento con la clave especificada.
CopyTo(Array, Int32)

Copia los elementos de la colección en una matriz, empezando por un índice de matriz determinado.
CopyTo(Array, Int32)

Copia todo el contenido de esta colección en una unidimensional Arraycompatible, empezando por el índice especificado de la matriz de destino.

(Heredado de ArrangedElementCollection)
Equals(Object)

Especifica si el objeto de colección actual y el objeto especificado son iguales.
Equals(Object)

Determina si dos ArrangedElementCollection instancias son iguales.

(Heredado de ArrangedElementCollection)
Find(String, Boolean)

Busca controles por su Name propiedad y crea una matriz de todos los controles que coinciden.
GetChildIndex(Control, Boolean)

Recupera el índice del control secundario especificado dentro de la colección de controles y, opcionalmente, genera una excepción si el control especificado no está dentro de la colección de controles.
GetChildIndex(Control)

Recupera el índice del control secundario especificado dentro de la colección de controles.
GetEnumerator()

Recupera una referencia a un objeto enumerador que se usa para iterar en un Control.ControlCollectionobjeto .
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 en la colección de controles.
IndexOfKey(String)

Recupera el índice de la primera aparición del elemento especificado dentro de la colección.
MemberwiseClone()

Crea una copia superficial del Objectactual.

(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 indizada especificada.
RemoveByKey(String)

Quita el control secundario con la clave especificada.
SetChildIndex(Control, Int32)

Establece el índice del control secundario especificado en la colección en el valor de índice especificado.
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Implementaciones de interfaz explícitas

Nombre Description
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 obtener una descripción de este miembro, vea la IsSynchronized propiedad .

(Heredado de ArrangedElementCollection)
ICollection.SyncRoot

Para obtener una descripción de este miembro, vea la SyncRoot propiedad .

(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, consulte el Clear() método .

(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, consulte el Contains(Object) método .

(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, consulte el IndexOf(Object) método .

(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, consulte el Insert(Int32, Object) método .

(Heredado de ArrangedElementCollection)
IList.IsFixedSize

Para obtener una descripción de este miembro, vea la IsFixedSize propiedad .

(Heredado de ArrangedElementCollection)
IList.Item[Int32]

Para obtener una descripción de este miembro, vea la Item[Int32] propiedad .

(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, consulte el RemoveAt(Int32) método .

(Heredado de ArrangedElementCollection)

Métodos de extensión

Nombre Description
AsParallel(IEnumerable)

Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)

Convierte un IEnumerable en un IQueryable.
Cast<TResult>(IEnumerable)

Convierte los elementos de un IEnumerable al tipo especificado.
OfType<TResult>(IEnumerable)

Filtra los elementos de un IEnumerable en función de un tipo especificado.

Se aplica a

Consulte también