Control.ControlCollection Classe

Définition

Représente une collection d’objets Control .

public: ref class Control::ControlCollection : ICloneable, System::Collections::IList
public: ref class Control::ControlCollection : System::Windows::Forms::Layout::ArrangedElementCollection, ICloneable, System::Collections::IList
[System.ComponentModel.ListBindable(false)]
public class Control.ControlCollection : ICloneable, System.Collections.IList
[System.ComponentModel.ListBindable(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public 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
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable
[<System.ComponentModel.ListBindable(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
type Control.ControlCollection = class
    inherit ArrangedElementCollection
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable
[<System.ComponentModel.ListBindable(false)>]
type Control.ControlCollection = class
    inherit ArrangedElementCollection
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable
Public Class Control.ControlCollection
Implements ICloneable, IList
Public Class Control.ControlCollection
Inherits ArrangedElementCollection
Implements ICloneable, IList
Héritage
Control.ControlCollection
Héritage
Control.ControlCollection
Dérivé
Attributs
Implémente

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 Panel, un Button, et 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 radioButton2 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

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

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

Constructeurs

Nom Description
Control.ControlCollection(Control)

Initialise une nouvelle instance de la classe Control.ControlCollection.

Propriétés

Nom Description
Count

Obtient le nombre d’éléments contenus dans la collection.

Count

Obtient le nombre d’éléments de la collection.

(Hérité de ArrangedElementCollection)
IsReadOnly

Obtient une valeur qui indique si cet objet de collection est en lecture seule.

IsReadOnly

Obtient une valeur indiquant si la collection est en lecture seule.

(Hérité de ArrangedElementCollection)
Item[Int32]

Indique l’emplacement Control indexé spécifié dans la collection.

Item[String]

Indique une Control clé avec la clé spécifiée dans la collection.

Owner

Obtient le contrôle propriétaire de ce Control.ControlCollection.

Méthodes

Nom Description
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 membre de la collection.

ContainsKey(String)

Détermine si le Control.ControlCollection contient un élément avec la clé spécifiée.

CopyTo(Array, Int32)

Copie les éléments de la collection dans un tableau, en commençant par un index de tableau particulier.

CopyTo(Array, Int32)

Copie l’intégralité du contenu de cette collection dans une dimension unidimensionnelle Arraycompatible, en commençant à l’index spécifié du tableau cible.

(Hérité de ArrangedElementCollection)
Equals(Object)

Spécifie si l’objet de collection actuel et l’objet spécifié sont égaux.

Equals(Object)

Détermine si deux ArrangedElementCollection instances sont égales.

(Hérité de ArrangedElementCollection)
Find(String, Boolean)

Recherche les contrôles par leur Name propriété et génère un tableau de tous les contrôles qui correspondent.

GetChildIndex(Control, Boolean)

Récupère l’index du contrôle enfant spécifié dans la collection de contrôles et déclenche éventuellement une exception si le contrôle spécifié n’est pas dans la collection de contrôles.

GetChildIndex(Control)

Récupère l’index du contrôle enfant spécifié dans la collection de contrôles.

GetEnumerator()

Récupère une référence à un objet énumérateur utilisé pour itérer sur un Control.ControlCollectionobjet .

GetHashCode()

Retourne le code de hachage pour cette instance.

GetHashCode()

Retourne le code de hachage pour cette instance.

(Hérité de ArrangedElementCollection)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
IndexOf(Control)

Récupère l’index du contrôle spécifié dans la collection de 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 Objectactuel.

(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 à l’emplacement indexé spécifié.

RemoveByKey(String)

Supprime le contrôle enfant avec la clé spécifiée.

SetChildIndex(Control, Int32)

Définit l’index du contrôle enfant spécifié dans la collection sur la valeur d’index spécifiée.

ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

Implémentations d’interfaces explicites

Nom Description
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 IsSynchronized propriété.

(Hérité de ArrangedElementCollection)
ICollection.SyncRoot

Pour obtenir une description de ce membre, consultez la SyncRoot propriété.

(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 Clear() méthode.

(Hérité de ArrangedElementCollection)
IList.Contains(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 Contains(Object).

IList.Contains(Object)

Pour obtenir une description de ce membre, consultez la Contains(Object) méthode.

(Hérité de ArrangedElementCollection)
IList.IndexOf(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 IndexOf(Object).

IList.IndexOf(Object)

Pour obtenir une description de ce membre, consultez la IndexOf(Object) méthode.

(Hérité de ArrangedElementCollection)
IList.Insert(Int32, 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 Insert(Int32, Object).

IList.Insert(Int32, Object)

Pour obtenir une description de ce membre, consultez la Insert(Int32, Object) méthode.

(Hérité de ArrangedElementCollection)
IList.IsFixedSize

Pour obtenir une description de ce membre, consultez la IsFixedSize propriété.

(Hérité de ArrangedElementCollection)
IList.Item[Int32]

Pour obtenir une description de ce membre, consultez la Item[Int32] propriété.

(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 RemoveAt(Int32) méthode.

(Hérité de ArrangedElementCollection)

Méthodes d’extension

Nom Description
AsParallel(IEnumerable)

Active la parallélisation d’une requête.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.

Cast<TResult>(IEnumerable)

Convertit les éléments d’un IEnumerable en type spécifié.

OfType<TResult>(IEnumerable)

Filtre les éléments d’une IEnumerable en fonction d’un type spécifié.

S’applique à

Voir aussi