Control.ControlCollection (Clase)
Actualización: noviembre 2007
Representa una colección de objetos Control.
Ensamblado: System.Windows.Forms (en System.Windows.Forms.dll)
[ListBindableAttribute(false)] [ComVisibleAttribute(false)] public class ControlCollection : ArrangedElementCollection, IList, ICollection, IEnumerable, ICloneable
/** @attribute ListBindableAttribute(false) */ /** @attribute ComVisibleAttribute(false) */ public class ControlCollection extends ArrangedElementCollection implements IList, ICollection, IEnumerable, ICloneable
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 objeto Control de la colección Control.ControlCollection de la clase derivada Panel, si se trata de un miembro de la colección. El ejemplo requiere que se haya creado con anterioridad un control Panel, un control Button y al menos un control RadioButton en un objeto 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 opción denominado radioButton2 se quita de la colección 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); } }
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
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.