Control.ControlCollection Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Représente une collection d'objets Control.

public: ref class Control::ControlCollection : System::Windows::Forms::Layout::ArrangedElementCollection, ICloneable, System::Collections::IList

[System.ComponentModel.ListBindable(false)]
public class Control.ControlCollection : System.Windows.Forms.Layout.ArrangedElementCollection, ICloneable, System.Collections.IList

[<System.ComponentModel.ListBindable(false)>]
type Control.ControlCollection = class
    inherit ArrangedElementCollection
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

Public Class Control.ControlCollection
Inherits ArrangedElementCollection
Implements ICloneable, IList

Héritage

Object

ArrangedElementCollection

Control.ControlCollection

Dérivé

System.Windows.Forms.DataGridView.DataGridViewControlCollection

System.Windows.Forms.Form.ControlCollection

System.Windows.Forms.MdiClient.ControlCollection

System.Windows.Forms.TabControl.ControlCollection

System.Windows.Forms.TableLayoutControlCollection

System.Windows.Forms.TabPage.TabPageControlCollection

Attributs

ListBindableAttribute

Implémente

ICollection IEnumerable IList ICloneable

Exemples

L’exemple de code suivant supprime un Control du Control.ControlCollection de la classe Panel dérivée s’il est membre de la collection. L’exemple exige que vous ayez créé un , un Buttonet au moins un RadioButton contrôle sur un Form.Panel Les RadioButton contrôles sont ajoutés au Panel contrôle et le Panel contrôle ajouté au Form. Lorsque vous cliquez sur le bouton, la case d’option nommée radioButton2 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 );
      }
   }

// 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

Les Addméthodes , Removeet RemoveAt vous permettent d’ajouter et de supprimer des contrôles individuels de la collection. Vous pouvez également utiliser les AddRange méthodes ou Clear pour ajouter ou supprimer tous les contrôles de la collection.

Vous pouvez déterminer si un Control est membre de la collection en passant le contrôle dans la Contains méthode . Pour obtenir la valeur d’index de l’emplacement d’un Control dans la collection, passez le contrôle à la IndexOf méthode . La collection peut être copiée dans un tableau en appelant la CopyTo méthode .

Constructeurs

Control.ControlCollection(Control)

Initialise une nouvelle instance de la classe Control.ControlCollection.

Propriétés

Count	Obtient le nombre d’éléments de la collection. (Hérité de ArrangedElementCollection)
IsReadOnly	Obtient une valeur indiquant si la collection est en lecture seule. (Hérité de ArrangedElementCollection)
Item[Int32]	Indique le Control à l'index spécifié dans la collection.
Item[String]	Indique un Control contenant la clé spécifiée de la collection.
Owner	Obtient le contrôle auquel appartient Control.ControlCollection.

Méthodes

Add(Control)	Ajoute le contrôle spécifié à la collection de contrôles.
AddRange(Control[])	Ajoute un tableau d'objets de contrôle à la collection.
Clear()	Supprime tous les contrôles de la collection.
Contains(Control)	Détermine si le contrôle spécifié est un membre de la collection.
ContainsKey(String)	Détermine si Control.ControlCollection contient un élément avec la clé spécifiée.
CopyTo(Array, Int32)	Copie le contenu entier de cette collection dans un Array unidimensionnel compatible, en commençant à l'index spécifié du tableau cible. (Hérité de ArrangedElementCollection)
Equals(Object)	Détermine si deux instances ArrangedElementCollection sont égales. (Hérité de ArrangedElementCollection)
Find(String, Boolean)	Recherche les contrôles selon leur propriété Name et génère un tableau de tous les contrôles qui correspondent.
GetChildIndex(Control)	Récupère l'index du contrôle enfant spécifié dans la collection des contrôles.
GetChildIndex(Control, Boolean)	Récupère l'index du contrôle enfant spécifié dans la collection de contrôles et lève éventuellement une exception si le contrôle spécifié n'est pas dans la collection de contrôles.
GetEnumerator()	Récupère une référence à un objet énumérateur utilisé pour parcourir une Control.ControlCollection.
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de ArrangedElementCollection)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IndexOf(Control)	Récupère l'index du contrôle enfant spécifié dans la collection des contrôles.
IndexOfKey(String)	Récupère l'index de la première occurrence de l'élément spécifié dans la collection.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(Control)	Supprime le contrôle spécifié de la collection de contrôles.
RemoveAt(Int32)	Supprime un contrôle de la collection de contrôles au niveau de l'emplacement d'index spécifié.
RemoveByKey(String)	Supprime le contrôle enfant contenant la clé spécifiée.
SetChildIndex(Control, Int32)	Attribue la valeur d'index spécifiée à l'index du contrôle enfant spécifié dans la collection.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

ICloneable.Clone()	Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code. Pour obtenir une description de ce membre, consultez Clone().
ICollection.IsSynchronized	Pour obtenir une description de ce membre, consultez la propriétéIsSynchronized. (Hérité de ArrangedElementCollection)
ICollection.SyncRoot	Pour obtenir une description de ce membre, consultez la propriétéSyncRoot. (Hérité de ArrangedElementCollection)
IList.Add(Object)	Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code. Pour obtenir une description de ce membre, consultez Add(Object).
IList.Clear()	Pour obtenir une description de ce membre, consultez la méthode Clear(). (Hérité de ArrangedElementCollection)
IList.Contains(Object)	Pour obtenir une description de ce membre, consultez la méthode Contains(Object). (Hérité de ArrangedElementCollection)
IList.IndexOf(Object)	Pour obtenir une description de ce membre, consultez la méthode IndexOf(Object). (Hérité de ArrangedElementCollection)
IList.Insert(Int32, Object)	Pour obtenir une description de ce membre, consultez la méthode Insert(Int32, Object). (Hérité de ArrangedElementCollection)
IList.IsFixedSize	Pour obtenir une description de ce membre, consultez la propriétéIsFixedSize. (Hérité de ArrangedElementCollection)
IList.Item[Int32]	Pour obtenir une description de ce membre, consultez la propriétéItem[Int32]. (Hérité de ArrangedElementCollection)
IList.Remove(Object)	Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code. Pour obtenir une description de ce membre, consultez Remove(Object).
IList.RemoveAt(Int32)	Pour obtenir une description de ce membre, consultez la méthode RemoveAt(Int32). (Hérité de ArrangedElementCollection)

Méthodes d’extension

Voir aussi

• Control
• IList