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 un de Control la Control.ControlCollection classe dérivée Panel s’il s’agit d’un membre de la collection. L’exemple requiert que vous ayez créé un Panel , un Button et au moins un RadioButton contrôle sur un Form . Le ou les RadioButton contrôle (s) sont ajoutés au Panel contrôle et le Panel contrôle est ajouté au Form . Quand l’utilisateur clique sur le bouton, la case removeButton d’option nommée 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 d’une collection de contrôles. Par exemple, lorsque plusieurs contrôles sont ajoutés à un Form , chacun des contrôles est un membre du Control.ControlCollection assigné à la Controls propriété du formulaire, qui est dérivé de la Control classe.

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

Quand vous ajoutez 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 augmentera les performances des applications avec de nombreux contrôles.

Utilisez la Controls propriété pour itérer au sein de 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