Control.Controls Propiedad

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

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.

Atributos

Ejemplos

En el ejemplo de código siguiente se quita un Control del Control.ControlCollection de la clase derivada Panel si es un miembro de la colección.The 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 control de RadioButton en un Form.The example requires that you have created a Panel, a Button, and at least one RadioButton control on a Form. Los controles de RadioButton se agregan al control Panel y se agrega el control Panel al Form.The RadioButton control(s) are added to the Panel control, and the Panel control added to the Form. Al hacer clic en el botón, se quita del Control.ControlCollectionel botón de radio denominado removeButton.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 un Form, cada uno de los controles es miembro del Control.ControlCollection asignado a la propiedad Controls del formulario, que se deriva de la clase Control.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 del Control.ControlCollection asignado a la propiedad Controls mediante los métodos disponibles en la clase Control.ControlCollection.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 método SuspendLayout 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 al método ResumeLayout.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 propiedad Controls 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. Utilice el método GetNextControl 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. Use la propiedad ActiveControl 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: