Control.ControlCollection Clase

Definición

Representa una colección de objetos Control.Represents a collection of Control objects.

public: ref class Control::ControlCollection : System::Windows::Forms::Layout::ArrangedElementCollection, ICloneable, System::Collections::IList
public: ref class Control::ControlCollection : 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)]
[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 : ICloneable, System.Collections.IList
[<System.ComponentModel.ListBindable(false)>]
type Control.ControlCollection = class
    inherit ArrangedElementCollection
    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
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable
Public Class Control.ControlCollection
Inherits ArrangedElementCollection
Implements ICloneable, IList
Public Class Control.ControlCollection
Implements ICloneable, IList
Herencia
Control.ControlCollection
Herencia
Control.ControlCollection
Derivado
Atributos
Implementaciones

Ejemplos

En el ejemplo de código siguiente se quita un de la Control Control.ControlCollection clase derivada Panel si es un miembro de la colección.The following code example removes a Control from the Control.ControlCollection of the derived class Panel if it is a member of the collection. El ejemplo requiere que se haya creado un Panel , un Button y al menos un RadioButton control en un Form .The example requires that you have created a Panel, a Button, and at least one RadioButton control on a Form. Los RadioButton controles se agregan al Panel control y el Panel control se agrega a Form .The RadioButton controls are added to the Panel control, and the Panel control added to the Form. Cuando se hace clic en el botón, el botón de radio denominado radioButton2 se quita de Control.ControlCollection .When the button is clicked, the radio button named radioButton2 is removed from the 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 Add Remove métodos, y RemoveAt permiten agregar y quitar controles individuales de la colección.The Add, Remove, and RemoveAt methods enable you to add and remove individual controls from the collection. También puede utilizar los AddRange métodos o Clear para agregar o quitar todos los controles de la colección.You can also use the AddRange or Clear methods to add or remove all the controls from the collection.

Puede determinar si un Control elemento es un miembro de la colección pasando el control al Contains método.You can determine if a Control is a member of the collection by passing the control into the Contains method. Para obtener el valor de índice de la ubicación de Control en la colección, pase el control al IndexOf método.To get the index value of the location of a Control in the collection, pass the control into the IndexOf method. La colección se puede copiar en una matriz llamando al CopyTo método.The collection can be copied into an array by calling the CopyTo method.

Constructores

Control.ControlCollection(Control)

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

Propiedades

Count

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

Count

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

(Heredado de ArrangedElementCollection)
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.

IsReadOnly

Obtiene un valor que indica si la colección es de solo lectura.Gets a value indicating whether the collection is read-only.

(Heredado de ArrangedElementCollection)
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.

Item[String]

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

Owner

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

Métodos

Add(Control)

Agrega el control especificado a la colección de controles.Adds the specified control to the control collection.

AddRange(Control[])

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

Clear()

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

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.

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.

CopyTo(Array, Int32)

Copia los elementos de la colección en una matriz, comenzando desde un índice de matriz determinado.Copies the elements of the collection to an array, starting at a particular array index.

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.Copies the entire contents of this collection to a compatible one-dimensional Array, starting at the specified index of the target array.

(Heredado de ArrangedElementCollection)
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.

Equals(Object)

Determina si dos instancias de ArrangedElementCollection son iguales.Determines whether two ArrangedElementCollection instances are equal.

(Heredado de ArrangedElementCollection)
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.

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.

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.

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.

GetHashCode()

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

GetHashCode()

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

(Heredado de ArrangedElementCollection)
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.

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.

MemberwiseClone()

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

(Heredado de Object)
Remove(Control)

Quita el control especificado de la colección de controles.Removes the specified control from the control collection.

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.

RemoveByKey(String)

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

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.

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()

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().For a description of this member, see Clone().

ICollection.IsSynchronized

Para una descripción de este miembro, consulte la propiedad IsSynchronized.For a description of this member, see the IsSynchronized property.

(Heredado de ArrangedElementCollection)
ICollection.SyncRoot

Para una descripción de este miembro, consulte la propiedad SyncRoot.For a description of this member, see the SyncRoot property.

(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).For a description of this member, see Add(Object).

IList.Clear()

Para obtener una descripción de este miembro, vea el método Clear().For a description of this member, see the Clear() method.

(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).For a description of this member, see Contains(Object).

IList.Contains(Object)

Para obtener una descripción de este miembro, vea el método Contains(Object).For a description of this member, see the Contains(Object) method.

(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).For a description of this member, see IndexOf(Object).

IList.IndexOf(Object)

Para obtener una descripción de este miembro, vea el método IndexOf(Object).For a description of this member, see the IndexOf(Object) method.

(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).For a description of this member, see Insert(Int32, Object).

IList.Insert(Int32, Object)

Para obtener una descripción de este miembro, vea el método Insert(Int32, Object).For a description of this member, see the Insert(Int32, Object) method.

(Heredado de ArrangedElementCollection)
IList.IsFixedSize

Para una descripción de este miembro, consulte la propiedad IsFixedSize.For a description of this member, see the IsFixedSize property.

(Heredado de ArrangedElementCollection)
IList.Item[Int32]

Para una descripción de este miembro, consulte la propiedad Item[Int32].For a description of this member, see the Item[Int32] property.

(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).For a description of this member, see Remove(Object).

IList.RemoveAt(Int32)

Para obtener una descripción de este miembro, vea el método RemoveAt(Int32).For a description of this member, see the RemoveAt(Int32) method.

(Heredado de ArrangedElementCollection)

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