Control.ControlCollection.Add(Control) Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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 -> unit
Public Overridable Sub Add (value As Control)

Paramètres

value
Control

Control à ajouter à la collection.

Exceptions

Exception

Le contrôle spécifié est un contrôle de niveau supérieur, sans quoi une référence de contrôle circulaire aurait pour effet d'ajouter ce contrôle à la collection du contrôle.

ArgumentException

L'objet assigné au paramètre value n'est pas Control.

Exemples

L’exemple de code suivant ajoute une 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 des Control 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 que vous avez précédemment ajouté, utilisez les méthodes, RemoveAtClear ou les Removeméthodes.

Notes

Une Control seule peut être attribuée à une Control.ControlCollection à la fois. Si l’enfant Control d’un autre contrôle est déjà 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 Add(Control) la classe de base pour vous assurer que le contrôle est ajouté à la collection.

S’applique à

Voir aussi