Form.ControlCollection Classe

Définition

Représente une collection de contrôles sur le formulaire.Represents a collection of controls on the form.

public: ref class Form::ControlCollection : System::Windows::Forms::Control::ControlCollection
public class Form.ControlCollection : System.Windows.Forms.Control.ControlCollection
[System.Runtime.InteropServices.ComVisible(false)]
public class Form.ControlCollection : System.Windows.Forms.Control.ControlCollection
type Form.ControlCollection = class
    inherit Control.ControlCollection
Public Class Form.ControlCollection
Inherits Control.ControlCollection
Héritage
Héritage
Form.ControlCollection
Attributs

Exemples

L’exemple de code suivant ajoute un contrôle TextBox et Label à la collection de contrôles d’un formulaire.The following code example adds a TextBox and Label control to the control collection of a form. L’exemple requiert qu’un formulaire ait été créé et nommé Form1.The example requires that a form has been created and named Form1.

public:
   void AddMyControls()
   {
      TextBox^ textBox1 = gcnew TextBox;
      Label^ label1 = gcnew Label;
      
      // Initialize the controls and their bounds.
      label1->Text = "First Name";
      label1->Location = Point( 48, 48 );
      label1->Size = System::Drawing::Size( 104, 16 );
      textBox1->Text = "";
      textBox1->Location = Point(48,64);
      textBox1->Size = System::Drawing::Size( 104, 16 );
      
      // Add the TextBox control to the form's control collection.
      Controls->Add( textBox1 );
      // Add the Label control to the form's control collection.
      Controls->Add( label1 );
   }
public void AddMyControls()
 {
    TextBox textBox1 = new TextBox();
    Label label1 = new Label();
    
    // Initialize the controls and their bounds.
    label1.Text = "First Name";
    label1.Location = new Point(48,48);
    label1.Size = new Size (104, 16);
    textBox1.Text = "";
    textBox1.Location = new Point(48, 64);
    textBox1.Size = new Size(104,16);
 
    // Add the TextBox control to the form's control collection.
    Controls.Add(textBox1);
    // Add the Label control to the form's control collection.
    Controls.Add(label1);
 }
 
Public Sub AddMyControls()
    Dim textBox1 As New TextBox()
    Dim label1 As New Label()
    
    ' Initialize the controls and their bounds.
    label1.Text = "First Name"
    label1.Location = New Point(48, 48)
    label1.Size = New Size(104, 16)
    textBox1.Text = ""
    textBox1.Location = New Point(48, 64)
    textBox1.Size = New Size(104, 16)
    
    ' Add the TextBox control to the form's control collection.
    Controls.Add(textBox1)
    ' Add the Label control to the form's control collection.
    Controls.Add(label1)
End Sub

Remarques

Cette classe représente la collection de contrôles contenus dans un formulaire.This class represents the collection of controls contained within a form. Vous pouvez utiliser la méthode Add pour ajouter un contrôle au formulaire et la méthode Remove pour supprimer le contrôle du formulaire.You can use the Add method to add a control to the form and the Remove method to remove the control from the form. La collection de contrôles représentée par cette classe ne peut pas être créée sans la lier à un formulaire spécifique.The control collection represented by this class cannot be created without binding it to a specific form. Par conséquent, vous ne pouvez pas créer plusieurs instances de cette collection de contrôles et les échanger avec un formulaire actif pour fournir des dispositions de contrôle différentes.As a result, you cannot create multiple instances of this control collection and interchange them with an active form to provide different control layouts.

Constructeurs

Form.ControlCollection(Form)

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

Propriétés

Count

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

(Hérité de Control.ControlCollection)
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.

(Hérité de Control.ControlCollection)
Item[Int32]

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

(Hérité de Control.ControlCollection)
Item[String]

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

(Hérité de Control.ControlCollection)
Owner

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

(Hérité de Control.ControlCollection)

Méthodes

Add(Control)

Ajoute un contrôle au formulaire.Adds a control to the form.

AddRange(Control[])

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

(Hérité de Control.ControlCollection)
Clear()

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

(Hérité de Control.ControlCollection)
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.

(Hérité de Control.ControlCollection)
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.

(Hérité de Control.ControlCollection)
CopyTo(Array, Int32)

Copie les éléments de la collection vers un tableau, en démarrant à un index de tableau particulier.Copies the elements of the collection to an array, starting at a particular array index.

(Hérité de Control.ControlCollection)
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.

(Hérité de Control.ControlCollection)
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.

(Hérité de Control.ControlCollection)
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.

(Hérité de Control.ControlCollection)
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.

(Hérité de Control.ControlCollection)
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.

(Hérité de Control.ControlCollection)
GetHashCode()

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

(Hérité de Control.ControlCollection)
GetType()

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

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

(Hérité de Control.ControlCollection)
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.

(Hérité de Control.ControlCollection)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

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

Supprime un contrôle du formulaire.Removes a control from the form.

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.

(Hérité de Control.ControlCollection)
RemoveByKey(String)

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

(Hérité de Control.ControlCollection)
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.

(Hérité de Control.ControlCollection)
ToString()

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

(Hérité de Object)

Implémentations d’interfaces explicites

ICloneable.Clone()

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

(Hérité de Control.ControlCollection)
ICollection.IsSynchronized

Pour obtenir une description de ce membre, consultez la propriété IsSynchronized .For a description of this member, see the IsSynchronized property.

(Hérité de ArrangedElementCollection)
ICollection.SyncRoot

Pour obtenir une description de ce membre, consultez la propriété SyncRoot .For a description of this member, see the SyncRoot property.

(Hérité de ArrangedElementCollection)
IList.Add(Object)

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

(Hérité de Control.ControlCollection)
IList.Clear()

Pour obtenir une description de ce membre, consultez la méthode Clear().For a description of this member, see the Clear() method.

(Hérité de ArrangedElementCollection)
IList.Contains(Object)

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

(Hérité de Control.ControlCollection)
IList.IndexOf(Object)

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

(Hérité de Control.ControlCollection)
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).

(Hérité de Control.ControlCollection)
IList.IsFixedSize

Pour obtenir une description de ce membre, consultez la propriété IsFixedSize .For a description of this member, see the IsFixedSize property.

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

Pour obtenir une description de ce membre, consultez la propriété Item[Int32] .For a description of this member, see the Item[Int32] property.

(Hérité de ArrangedElementCollection)
IList.Remove(Object)

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

(Hérité de Control.ControlCollection)
IList.RemoveAt(Int32)

Pour obtenir une description de ce membre, consultez la méthode RemoveAt(Int32).For a description of this member, see the RemoveAt(Int32) method.

(Hérité de ArrangedElementCollection)

Méthodes d’extension

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)

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)

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

AsQueryable(IEnumerable)

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

S’applique à

Voir aussi