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

Ejemplos

En el ejemplo de código siguiente se quita un Control del Control.ControlCollection de la clase derivada Panel si es 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 control RadioButton en Form.The example requires that you have created a Panel, a Button, and at least one RadioButton control on a Form. Los controles RadioButton se agregan al control Panel y el control Panel se agrega al Form.The RadioButton controls are added to the Panel control, and the Panel control added to the Form. Al hacer clic en el botón, se quita el botón de radio denominado radioButton2 del 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 métodos Add, Remove 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 métodos AddRange 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 es un miembro de la colección pasando el control al método Contains.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 un Control en la colección, pase el control al método IndexOf.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 método CopyTo.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 contenido en la colección.Gets the number of elements contained in the collection.

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.

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 a partir de un índice de matriz concreto.Copies the elements of the collection to an array, starting at a particular array index.

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.

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.

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 un valor de tipo string 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().

IList.Add(Object)

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

IList.Contains(Object)

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

IList.IndexOf(Object)

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

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

IList.Remove(Object)

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

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: