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

El código siguiente en el ejemplo se quita un Control desde el 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 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. El RadioButton controles se agregan a la Panel control y el Panel control agregado al Form.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 de radio denominado removeButton se quita de la Control.ControlCollection.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 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 un miembro de la Control.ControlCollection asignado a la Controls propiedad del formulario, que se deriva el 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 en el Control.ControlCollection asignado a la Controls propiedad mediante el uso de 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 principal, se recomienda que llame el SuspendLayout método antes de inicializar los controles que se va 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 a la ResumeLayout método.After adding the controls to the parent control, call the ResumeLayout method. Si lo hace, aumentará el rendimiento de aplicaciones con muchos controles.Doing so will increase the performance of applications with many controls.

Use el 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. Use el ActiveControl propiedad va a 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: