Control.Controls Propriété

Définition

Obtient la collection de contrôles contenus dans le contrôle.

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

Valeur de propriété

Control.ControlCollection

Control.ControlCollection représentant la collection de contrôles contenus dans le contrôle.

Attributs

Exemples

L’exemple de code suivant supprime une Control de la Control.ControlCollection classe Panel dérivée s’il est membre de la collection. L’exemple nécessite que vous ayez créé un , un PanelButtonet au moins un RadioButton contrôle sur un Form. Les RadioButton contrôles sont ajoutés au Panel contrôle et le Panel contrôle ajouté au Form. Lorsque le bouton est cliqué, la case d’option nommée removeButton est supprimée du 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

Remarques

Un Control peut agir en tant que parent à une collection de contrôles. Par exemple, lorsque plusieurs contrôles sont ajoutés à un Form, chacun des contrôles est membre de Control.ControlCollection la Controls propriété du formulaire, qui est dérivée de la Control classe.

Vous pouvez manipuler les contrôles dans la propriété affectée à l’aide Control.ControlCollection Controls des méthodes disponibles dans la Control.ControlCollection classe.

Lors de l’ajout de plusieurs contrôles à un contrôle parent, il est recommandé d’appeler la SuspendLayout méthode avant d’initialiser les contrôles à ajouter. Après avoir ajouté les contrôles au contrôle parent, appelez la ResumeLayout méthode. Cela augmente les performances des applications avec de nombreux contrôles.

Utilisez la Controls propriété pour itérer dans tous les contrôles d’un formulaire, y compris les contrôles imbriqués. Utilisez la GetNextControl méthode pour récupérer le contrôle enfant précédent ou suivant dans l’ordre de tabulation. Utilisez la ActiveControl propriété pour obtenir ou définir le contrôle actif d’un contrôle conteneur.

S’applique à

Voir aussi