Exportar (0) Imprimir
Expandir todo
Expandir Minimizar

Control.Controls (Propiedad)

Obtiene la colección de controles que contiene el control.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

public ControlCollection Controls { get; }
/** @property */
public ControlCollection get_Controls ()

public function get Controls () : ControlCollection

No aplicable.

Valor de propiedad

Control.ControlCollection que representa la colección de controles que contiene el control.

Control puede actuar de control principal de una colección de controles. Por ejemplo, cuando se agregan varios controles a un Form, cada uno de los controles se convierte en un miembro de la clase Control.ControlCollection asignada a la propiedad Controls del formulario, que se deriva de la clase Control.

Para manipular los controles de la clase Control.ControlCollection asignada a la propiedad Controls, utilice los métodos disponibles en la clase Control.ControlCollection.

Cuando se agregan varios controles a un control principal, es recomendable llamar al método SuspendLayout antes de inicializar los controles que se van a agregar. Después de agregar los controles al control principal, hay que llamar al método ResumeLayout. De esta forma, aumenta el rendimiento de las aplicaciones que tienen muchos controles.

Utilice la propiedad Controls para recorrer en iteración todos los controles de un formulario, incluidos los controles anidados. Utilice el método GetNextControl para recuperar el control secundario anterior o posterior en el orden de tabulación. Utilice la propiedad ActiveControl para obtener o establecer el control activo de un control contenedor.

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 a Form. Al hacer clic en el botón, el botón de opción 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.get_Controls().Contains(removeButton)) {
        panel1.get_Controls().Remove(removeButton);
    }
} //removeButton_Click

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0, 1.0
Mostrar:
© 2014 Microsoft