Control.ControlCollection.Add(Control) Méthode
Définition
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.
Ajoute le contrôle spécifié à la collection de contrôles.
public:
virtual void Add(System::Windows::Forms::Control ^ value);public virtual void Add(System.Windows.Forms.Control value);public virtual void Add(System.Windows.Forms.Control? value);abstract member Add : System.Windows.Forms.Control -> unit
override this.Add : System.Windows.Forms.Control -> unitPublic Overridable Sub Add (value As Control)Paramètres
Exceptions
Le contrôle spécifié est un contrôle de niveau supérieur, ou une référence de contrôle circulaire se traduirait par l’ajout de ce contrôle à la collection de contrôles.
L’objet affecté au value paramètre n’est pas un Control.
Exemples
L’exemple de code suivant ajoute un Control à la Control.ControlCollection classe Paneldérivée. L’exemple nécessite que vous ayez créé un Panel contrôle et un Button contrôle sur un Form. Lorsque le bouton est cliqué, un TextBox contrôle est ajouté au panneau Control.ControlCollection.
// Create a TextBox to add to the Panel.
private:
TextBox^ textBox1;
// Add controls to the Panel using the Add method.
void addButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
textBox1 = gcnew TextBox;
panel1->Controls->Add( textBox1 );
}
// Create a TextBox to add to the Panel.
private TextBox textBox1 = new TextBox();
// Add controls to the Panel using the Add method.
private void addButton_Click(object sender, System.EventArgs e)
{
panel1.Controls.Add(textBox1);
}
' Create a TextBox to add to the Panel.
Dim TextBox1 As TextBox = New TextBox()
' Add controls to the Panel using the Add method.
Private Sub AddButton_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles AddButton.Click
Panel1.Controls.Add(TextBox1)
End Sub
Remarques
La Add méthode vous permet d’ajouter Control des objets à la fin de la collection de contrôles.
Vous pouvez également ajouter de nouveaux Control objets à la collection à l’aide de la AddRange méthode.
Pour supprimer un Control élément que vous avez ajouté précédemment, utilisez les méthodes ou les RemoveméthodesRemoveAtClear.
Note
Un Control seul peut être attribué à un à la Control.ControlCollection fois. Si le Control contrôle est déjà un enfant d’un autre contrôle, il est supprimé de ce contrôle avant d’être ajouté à un autre contrôle.
Notes pour les héritiers
En cas de Add(Control) substitution dans une classe dérivée, veillez à appeler la méthode de la classe de Add(Control) base pour vous assurer que le contrôle est ajouté à la collection.
