Control.Controls Control.Controls Control.Controls Control.Controls Property

Definición

Obtiene la colección de controles que contiene el control.Gets the collection of controls contained within the 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; }
member this.Controls : System.Windows.Forms.Control.ControlCollection
Public ReadOnly Property Controls As Control.ControlCollection

Valor de propiedad

Control.ControlCollection que representa la colección de controles incluidos en el control.A Control.ControlCollection representing the collection of controls contained within the control.

Ejemplos

En el ejemplo de código siguiente Control se quita un de la clase Panel derivada si es un miembro de la colección. Control.ControlCollectionThe following code example removes a Control from the Control.ControlCollection of the derived class Panel if it is a member of the collection. El ejemplo requiere que se haya creado un Panel, un Buttony al menos un RadioButton control en un Form.The example requires that you have created a Panel, a Button, and at least one RadioButton control on a Form. Los RadioButton controles se agregan Panel al control y Formel Panel control se agrega a.The RadioButton control(s) are added to the Panel control, and the Panel control added to the Form. Cuando se hace clic en el botón, el botón removeButton Control.ControlCollectionde radio denominado se quita de.When the button is clicked, the radio button named removeButton is removed from the 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 de una colección de controles.A Control can act as a parent to a collection of controls. Por ejemplo, cuando se agregan varios controles a Formun, cada uno de los controles es miembro Control.ControlCollection del asignado a la Controls propiedad del formulario, que se deriva de la Control clase.For example, when several controls are added to a Form, each of the controls is a member of the Control.ControlCollection assigned to the Controls property of the form, which is derived from the Control class.

Puede manipular los controles de Control.ControlCollection asignados a la Controls propiedad mediante los métodos disponibles en la Control.ControlCollection clase.You can manipulate the controls in the Control.ControlCollection assigned to the Controls property by using the methods available in the Control.ControlCollection class.

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.When adding several controls to a parent control, it is recommended that you call the SuspendLayout method before initializing the controls to be added. Después de agregar los controles al control primario, llame ResumeLayout al método.After adding the controls to the parent control, call the ResumeLayout method. Si lo hace, aumentará el rendimiento de las aplicaciones con muchos controles.Doing so will increase the performance of applications with many controls.

Utilice la Controls propiedad para recorrer en iteración todos los controles de un formulario, incluidos los controles anidados.Use the Controls property to iterate through all controls of a form, including nested controls. Use el GetNextControl método para recuperar el control secundario anterior o siguiente en el orden de tabulación.Use the GetNextControl method to retrieve the previous or next child control in the tab order. Utilice la ActiveControl propiedad para obtener o establecer el control activo de un control contenedor.Use the ActiveControl property to get or set the active control of a container control.

Se aplica a

Consulte también: