Control (Propiedades)


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)

Sintaxis

Visual Basic (Declaración)
Public ReadOnly Property Controls As ControlCollection
Visual Basic (Uso)
Dim instance As Control
Dim value As ControlCollection

value = instance.Controls
C#
public ControlCollection Controls { get; }
C++
public:
property ControlCollection^ Controls {
    ControlCollection^ get ();
}
J#
/** @property */
public ControlCollection get_Controls ()
JScript
public function get Controls () : ControlCollection
XAML
No aplicable.

Valor de propiedad

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

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.

Ejemplo

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.

Visual Basic
' 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(RadioAddRangeButton) Then
        Panel1.Controls.Remove(RadioAddRangeButton)
    End If
End Sub
C#
// 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);
   }
}
C++
   // 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 );
      }
   }
J#
// 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
Plataformas

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.

Información de versión

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0, 1.0
Vea también

Page view tracker