Exporter (0) Imprimer
Développer tout
Développer Réduire
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Control.Controls, propriété

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

Espace de noms :  System.Windows.Forms
Assembly :  System.Windows.Forms (dans System.Windows.Forms.dll)

[BrowsableAttribute(false)]
public Control.ControlCollection Controls { get; }

Valeur de propriété

Type : System.Windows.Forms.Control.ControlCollection
Control.ControlCollection représentant la collection de contrôles contenus dans le contrôle.

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

Vous pouvez manipuler les contrôles dans Control.ControlCollection assigné à la propriété Controls en utilisant les méthodes accessibles dans la classe Control.ControlCollection.

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

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

L'exemple de code suivant supprime Control du Control.ControlCollection de la classe dérivée Panel s'il s'agit d'un membre de la collection. L'exemple suppose que vous ayez créé Panel, Button et au moins un contrôle RadioButton sur Form. Le ou les contrôles RadioButton sont ajoutés au contrôle Panel et le contrôle Panel est ajouté à Form. Lors d'un clic sur le bouton, la case d'option appelée removeButton est supprimée de 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);
   }
}


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft