Form.ControlCollection Classe

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente une collection de contrôles sur le formulaire.

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

[<System.Runtime.InteropServices.ComVisible(false)>]
type Form.ControlCollection = class
    inherit Control.ControlCollection

Public Class Form.ControlCollection
Inherits Control.ControlCollection

Héritage: Object

Control.ControlCollection
Form.ControlCollection

Héritage: Object

ArrangedElementCollection

Control.ControlCollection
Form.ControlCollection

Attributs: ComVisibleAttribute

Exemples

L’exemple de code suivant ajoute un TextBox contrôle et Label à la collection de contrôles d’un formulaire. L’exemple exige qu’un formulaire ait été créé et nommé 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. Vous pouvez utiliser la Add méthode pour ajouter un contrôle au formulaire et la Remove méthode pour supprimer le contrôle du formulaire. La collection de contrôles représentée par cette classe ne peut pas être créée sans la lier à un formulaire spécifique. 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 différentes dispositions de contrôle.

Constructeurs

Form.ControlCollection(Form)

Initialise une nouvelle instance de la classe Form.ControlCollection.

Propriétés

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

Méthodes

Add(Control)	Ajoute un contrôle au formulaire.
AddRange(Control[])	Ajoute un tableau d'objets de contrôle à la collection. (Hérité de Control.ControlCollection)
Clear()	Supprime tous les contrôles de la collection. (Hérité de Control.ControlCollection)
Contains(Control)	Détermine si le contrôle spécifié est un membre de la collection. (Hérité de Control.ControlCollection)
ContainsKey(String)	Détermine si Control.ControlCollection contient un élément avec la clé spécifiée. (Hérité de Control.ControlCollection)
CopyTo(Array, Int32)	Copie les éléments de la collection dans un tableau, en commençant au niveau d’un index de tableau particulier. (Hérité de Control.ControlCollection)
Equals(Object)	Spécifie si l’objet de collection actuel et l’objet spécifié sont égaux. (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. (Hérité de Control.ControlCollection)
GetChildIndex(Control)	Récupère l'index du contrôle enfant spécifié dans la collection des contrôles. (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. (Hérité de Control.ControlCollection)
GetEnumerator()	Récupère une référence à un objet énumérateur utilisé pour parcourir une Control.ControlCollection. (Hérité de Control.ControlCollection)
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de Control.ControlCollection)
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. (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. (Hérité de Control.ControlCollection)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(Control)	Supprime un contrôle du formulaire.
RemoveAt(Int32)	Supprime un contrôle de la collection de contrôles au niveau de l'emplacement d'index spécifié. (Hérité de Control.ControlCollection)
RemoveByKey(String)	Supprime le contrôle enfant contenant la clé spécifiée. (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. (Hérité de Control.ControlCollection)
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(). (Hérité de Control.ControlCollection)
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). (Hérité de Control.ControlCollection)
IList.Clear()	Pour obtenir une description de ce membre, consultez la méthode Clear(). (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). (Hérité de Control.ControlCollection)
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). (Hérité de Control.ControlCollection)
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). (Hérité de Control.ControlCollection)
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). (Hérité de Control.ControlCollection)
IList.RemoveAt(Int32)	Pour obtenir une description de ce membre, consultez la méthode RemoveAt(Int32). (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é.
OfType<TResult>(IEnumerable)	Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d'une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.

S’applique à

Voir aussi

Control.ControlCollection

Partager via