Control.ControlCollection Control.ControlCollection Control.ControlCollection Control.ControlCollection Class

Définition

Représente une collection d'objets Control.Represents a collection of Control objects.

public: ref class Control::ControlCollection : System::Windows::Forms::Layout::ArrangedElementCollection, 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
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
Control.ControlCollectionControl.ControlCollectionControl.ControlCollectionControl.ControlCollection
Dérivé
Attributs
Implémente

Exemples

L’exemple de code suivant supprime Control un de Control.ControlCollection la classe Panel dérivée s’il s’agit d’un membre de la collection.The following code example removes a Control from the Control.ControlCollection of the derived class Panel if it is a member of the collection. L’exemple requiert que vous ayez créé un Panel, un Buttonet au moins un RadioButton contrôle sur un Form.The example requires that you have created a Panel, a Button, and at least one RadioButton control on a Form. Les RadioButton contrôles sont ajoutés Panel au contrôle et Formle Panel contrôle est ajouté au.The RadioButton controls are added to the Panel control, and the Panel control added to the Form. Quand l’utilisateur clique sur le bouton, la case radioButton2 Control.ControlCollectiond’option nommée est supprimée du.When the button is clicked, the radio button named radioButton2 is removed from the 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 Remove, etRemoveAt vous permettent d’ajouter et de supprimer des contrôles individuels de la collection.The Add, Remove, and RemoveAt methods enable you to add and remove individual controls from the collection. Vous pouvez également utiliser les AddRange méthodes Clear ou pour ajouter ou supprimer tous les contrôles de la collection.You can also use the AddRange or Clear methods to add or remove all the controls from the collection.

Vous pouvez déterminer si un Control est un membre de la collection en passant le contrôle dans la Contains méthode.You can determine if a Control is a member of the collection by passing the control into the Contains method. Pour obtenir la valeur d’index de l’emplacement d' Control un dans la collection, transmettez le contrôle IndexOf à la méthode.To get the index value of the location of a Control in the collection, pass the control into the IndexOf method. La collection peut être copiée dans un tableau en appelant CopyTo la méthode.The collection can be copied into an array by calling the CopyTo method.

Constructeurs

Control.ControlCollection(Control) Control.ControlCollection(Control) Control.ControlCollection(Control) Control.ControlCollection(Control)

Initialise une nouvelle instance de la classe Control.ControlCollection.Initializes a new instance of the Control.ControlCollection class.

Propriétés

Count Count Count Count

Obtient le nombre d’éléments contenus dans la collection.Gets the number of elements contained in the collection.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Obtient une valeur qui indique si cet objet de collection est en lecture seule.Gets a value that indicates whether this collection object is read-only.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Indique le Control à l'index spécifié dans la collection.Indicates the Control at the specified indexed location in the collection.

Item[String] Item[String] Item[String] Item[String]

Indique un Control contenant la clé spécifiée de la collection.Indicates a Control with the specified key in the collection.

Owner Owner Owner Owner

Obtient le contrôle auquel appartient Control.ControlCollection.Gets the control that owns this Control.ControlCollection.

Méthodes

Add(Control) Add(Control) Add(Control) Add(Control)

Ajoute le contrôle spécifié à la collection de contrôles.Adds the specified control to the control collection.

AddRange(Control[]) AddRange(Control[]) AddRange(Control[]) AddRange(Control[])

Ajoute un tableau d'objets de contrôle à la collection.Adds an array of control objects to the collection.

Clear() Clear() Clear() Clear()

Supprime tous les contrôles de la collection.Removes all controls from the collection.

Contains(Control) Contains(Control) Contains(Control) Contains(Control)

Détermine si le contrôle spécifié est un membre de la collection.Determines whether the specified control is a member of the collection.

ContainsKey(String) ContainsKey(String) ContainsKey(String) ContainsKey(String)

Détermine si Control.ControlCollection contient un élément avec la clé spécifiée.Determines whether the Control.ControlCollection contains an item with the specified key.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Copie les éléments de la collection dans un tableau, en commençant au niveau d’un index de tableau particulier.Copies the elements of the collection to an array, starting at a particular array index.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Spécifie si l’objet de collection actuel et l’objet spécifié sont égaux.Specifies whether the current collection object and the specified object are equal.

Find(String, Boolean) Find(String, Boolean) Find(String, Boolean) 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.Searches for controls by their Name property and builds an array of all the controls that match.

GetChildIndex(Control) GetChildIndex(Control) GetChildIndex(Control) GetChildIndex(Control)

Récupère l'index du contrôle enfant spécifié dans la collection des contrôles.Retrieves the index of the specified child control within the control collection.

GetChildIndex(Control, Boolean) GetChildIndex(Control, Boolean) GetChildIndex(Control, Boolean) 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.Retrieves the index of the specified child control within the control collection, and optionally raises an exception if the specified control is not within the control collection.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Récupère une référence à un objet énumérateur utilisé pour parcourir une Control.ControlCollection.Retrieves a reference to an enumerator object that is used to iterate over a Control.ControlCollection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Retourne le code de hachage de cette instance.Returns the hash code for this instance.

GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(Control) IndexOf(Control) IndexOf(Control) IndexOf(Control)

Récupère l'index du contrôle enfant spécifié dans la collection des contrôles.Retrieves the index of the specified control in the control collection.

IndexOfKey(String) IndexOfKey(String) IndexOfKey(String) IndexOfKey(String)

Récupère l'index de la première occurrence de l'élément spécifié dans la collection.Retrieves the index of the first occurrence of the specified item within the collection.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(Control) Remove(Control) Remove(Control) Remove(Control)

Supprime le contrôle spécifié de la collection de contrôles.Removes the specified control from the control collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Supprime un contrôle de la collection de contrôles au niveau de l'emplacement d'index spécifié.Removes a control from the control collection at the specified indexed location.

RemoveByKey(String) RemoveByKey(String) RemoveByKey(String) RemoveByKey(String)

Supprime le contrôle enfant contenant la clé spécifiée.Removes the child control with the specified key.

SetChildIndex(Control, Int32) SetChildIndex(Control, Int32) SetChildIndex(Control, Int32) SetChildIndex(Control, Int32)

Attribue la valeur d'index spécifiée à l'index du contrôle enfant spécifié dans la collection.Sets the index of the specified child control in the collection to the specified index value.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Implémentations d’interfaces explicites

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

Pour obtenir une description de ce membre, consultez Clone().For a description of this member, see Clone().

IList.Add(Object) IList.Add(Object) IList.Add(Object) IList.Add(Object)

Pour obtenir une description de ce membre, consultez Add(Object).For a description of this member, see Add(Object).

IList.Contains(Object) IList.Contains(Object) IList.Contains(Object) IList.Contains(Object)

Pour obtenir une description de ce membre, consultez Contains(Object).For a description of this member, see Contains(Object).

IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object)

Pour obtenir une description de ce membre, consultez IndexOf(Object).For a description of this member, see IndexOf(Object).

IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object)

Pour obtenir une description de ce membre, consultez Insert(Int32, Object).For a description of this member, see Insert(Int32, Object).

IList.Remove(Object) IList.Remove(Object) IList.Remove(Object) IList.Remove(Object)

Pour obtenir une description de ce membre, consultez Remove(Object).For a description of this member, see Remove(Object).

Méthodes d’extension

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à

Voir aussi