Página de inicio Biblioteca Aprender Descargas Soporte técnico Comunidad
Iniciar sesión | United States - English | |
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

Control.ControlCollection (Clase)

.NET Framework 4

Representa una colección de objetos Control.

System.Object
  System.Windows.Forms.Layout.ArrangedElementCollection
    System.Windows.Forms.Control.ControlCollection
      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

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)
C#
C++
F#
VB
Copiar 
[ListBindableAttribute(false)]
[ComVisibleAttribute(false)]
public class ControlCollection : ArrangedElementCollection, 
	IList, ICollection, IEnumerable, ICloneable

El tipo Control.ControlCollection expone los siguientes miembros.

  Nombre Descripción
Método público Control.ControlCollection Inicializa una nueva instancia de la clase Control.ControlCollection.
Arriba
  Nombre Descripción
Propiedad pública Count Obtiene el número de elementos de la colección. (Se hereda de ArrangedElementCollection).
Propiedad pública IsReadOnly Obtiene un valor que indica si la colección es de sólo lectura. (Se hereda de ArrangedElementCollection).
Propiedad pública Item[Int32] Indica el objeto Control que se encuentra en la ubicación indizada especificada de la colección.
Propiedad pública Item[String] Indica un objeto Control con la clave especificada de la colección.
Propiedad pública Owner Obtiene el control al que pertenece esta colección Control.ControlCollection.
Arriba
  Nombre Descripción
Método público Add Agrega el control especificado a la colección de controles.
Método público AddRange Agrega una matriz de objetos de control a la colección.
Método público Clear Quita todos los controles de la colección.
Método público Contains Determina si el objeto especificado es un miembro de la colección.
Método público ContainsKey Determina si la colección Control.ControlCollection contiene un elemento con la clave especificada.
Método público CopyTo Copia todo el contenido de esta colección a una Array unidimensional compatible, empezando en el índice especificado de la matriz de destino. (Se hereda de ArrangedElementCollection).
Método público Equals Determina si dos instancias de ArrangedElementCollection son iguales. (Se hereda de ArrangedElementCollection).
Método protegido Finalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método público Find Busca los controles por su propiedad Name y genera una matriz de todos los controles que coinciden.
Método público GetChildIndex(Control) Recupera el índice de un control secundario especificado de la colección de controles.
Método público 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.
Método público GetEnumerator Recupera una referencia a un objeto del enumerador que se utiliza para recorrer en iteración la colección Control.ControlCollection. (Invalida a ArrangedElementCollection.GetEnumerator()).
Método público GetHashCode Devuelve el código hash de esta instancia. (Se hereda de ArrangedElementCollection).
Método público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método público IndexOf Recupera el índice del control especificado de la colección de controles.
Método público IndexOfKey Devuelve el índice de la primera aparición del elemento especificado en esta colección.
Método protegido MemberwiseClone Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método público Remove Quita el control especificado de la colección de controles.
Método público RemoveAt Quita un control de la colección de controles en la ubicación del índice especificada.
Método público RemoveByKey Quita el control secundario con la clave especificada.
Método público SetChildIndex Establece el índice el control secundario especificado en la colección como el valor de índice especificado.
Método público ToString Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
Arriba
  Nombre Descripción
Método de extensión público AsParallel Habilita la paralelización de una consulta. (Definido por ParallelEnumerable).
Método de extensión público AsQueryable Convierte una interfaz IEnumerable en IQueryable. (Definido por Queryable).
Método de extensión público Cast<TResult> Convierte los elementos de IEnumerable en el tipo especificado. (Definido por Enumerable).
Método de extensión público OfType<TResult> Filtra los elementos de IEnumerable en función de un tipo especificado. (Definido por Enumerable).
Arriba
  Nombre Descripción
Implementación explícita de interfaces Método privado ICloneable.Clone Infraestructura. Para obtener una descripción de este miembro, vea ICloneable.Clone.
Implementación explícita de interfaces Propiedad privada ICollection.IsSynchronized Para obtener una descripción de este miembro, vea la propiedad ICollection.IsSynchronized. (Se hereda de ArrangedElementCollection).
Implementación explícita de interfaces Propiedad privada ICollection.SyncRoot Para obtener una descripción de este miembro, vea la propiedad ICollection.SyncRoot. (Se hereda de ArrangedElementCollection).
Implementación explícita de interfaces Método privado IList.Add Infraestructura. Para obtener una descripción de este miembro, vea IList.Add.
Implementación explícita de interfaces Método privado IList.Clear Para obtener una descripción de este miembro, vea el método IList.Clear. (Se hereda de ArrangedElementCollection).
Implementación explícita de interfaces Método privado IList.Contains Para obtener una descripción de este miembro, vea el método IList.Contains. (Se hereda de ArrangedElementCollection).
Implementación explícita de interfaces Método privado IList.IndexOf Para obtener una descripción de este miembro, vea el método IList.IndexOf. (Se hereda de ArrangedElementCollection).
Implementación explícita de interfaces Método privado IList.Insert Para obtener una descripción de este miembro, vea el método IList.Insert. (Se hereda de ArrangedElementCollection).
Implementación explícita de interfaces Propiedad privada IList.IsFixedSize Para obtener una descripción de este miembro, vea la propiedad IList.IsFixedSize. (Se hereda de ArrangedElementCollection).
Implementación explícita de interfaces Propiedad privada IList.Item Para obtener una descripción de este miembro, vea la propiedad IList.Item. (Se hereda de ArrangedElementCollection).
Implementación explícita de interfaces Método privado IList.Remove Infraestructura. Para obtener una descripción de este miembro, vea IList.Remove.
Implementación explícita de interfaces Método privado IList.RemoveAt Para obtener una descripción de este miembro, vea el método IList.RemoveAt. (Se hereda de ArrangedElementCollection).
Arriba

Los métodos Add, Remove y RemoveAt permiten agregar y quitar controles individuales de la colección. Se puede utilizar también los métodos AddRange o Clear para agregar o quitar todos los controles de la colección.

Para determinar si un Control es miembro de la colección, pase el control al método Contains. Para obtener el valor del índice de la ubicación de un Control en la colección, pase el control al método IndexOf. Para copiar la colección en una matriz, llame al método CopyTo.

En el siguiente ejemplo de código se quita un Control de Control.ControlCollection de la clase derivada Panel si es miembro de la colección. En el ejemplo se requiere que se haya creado un control Panel, un control Button y al menos un control RadioButton en un Form. Los controles RadioButton se agregan al control Panel y el control Panel se agrega al objeto Form. Al hacer clic en el botón, el botón de radio denominado radioButton2 se quita de Control.ControlCollection.

C#
C++
VB
Copiar 

// 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);
   }
}

.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
¿Le ha resultado útil?
(Caracteres restantes: 1500)
Contenido de la comunidad Agregar
Anotaciones Preguntas más frecuentes