Control.Controls Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

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

public:
 property System::Windows::Forms::Control::ControlCollection ^ Controls { System::Windows::Forms::Control::ControlCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.Control.ControlCollection Controls { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Controls : System.Windows.Forms.Control.ControlCollection

Public ReadOnly Property Controls As Control.ControlCollection

Valor de propiedad

Control.ControlCollection

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

Atributos

BrowsableAttribute

Ejemplos

En el ejemplo de código siguiente se quita de Control de Control.ControlCollection la clase Panel derivada si es miembro de la colección. El ejemplo requiere que haya creado un Panelcontrol , y Buttonal menos un RadioButton control en .Form Los RadioButton controles se agregan al Panel control y el Panel control se agrega a Form. Cuando se hace clic en el botón, el botón de radio denominado removeButton 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.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

Un Control puede actuar como elemento primario en una colección de controles. Por ejemplo, cuando se agregan varios controles a , Formcada uno de los controles es un miembro de la Control.ControlCollection propiedad asignada al Controls formulario, que se deriva de la Control clase .

Puede manipular los controles de la Control.ControlCollection propiedad asignada mediante Controls los métodos disponibles en la Control.ControlCollection clase .

Al agregar varios controles a un control primario, se recomienda llamar al SuspendLayout método antes de inicializar los controles que se van a agregar. Después de agregar los controles al control primario, llame al ResumeLayout método . Si lo hace, aumentará el rendimiento de las aplicaciones con muchos controles.

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

Consulte también

• Control.ControlCollection
• CreateControlsInstance()
• SuspendLayout()
• ResumeLayout()