Control.ControlCollection.Add(Control) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee voegt u het opgegeven besturingselement toe aan de verzameling besturingselementen.
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)Parameters
Uitzonderingen
Het opgegeven besturingselement is een besturingselement op het hoogste niveau of een kringbesturingselementverwijzing zou resulteren als dit besturingselement is toegevoegd aan de verzameling besturingselementen.
Het object dat aan de value parameter is toegewezen, is geen Control.
Voorbeelden
In het volgende codevoorbeeld wordt een Control aan de Control.ControlCollection afgeleide klasse Paneltoegevoegd. In het voorbeeld moet u een Panel besturingselement en een Button besturingselement op een Formhebben gemaakt. Wanneer op de knop wordt geklikt, wordt een TextBox besturingselement toegevoegd aan het deelvenster 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
Opmerkingen
Met Add de methode kunt u objecten toevoegen Control aan het einde van de besturingselementverzameling.
U kunt ook nieuwe Control objecten toevoegen aan de verzameling met behulp van de AddRange methode.
Als u een Control die u eerder hebt toegevoegd, wilt verwijderen, gebruikt u de Removeof RemoveAtClear methoden.
Note
Een Control kan slechts één Control.ControlCollection voor één worden toegewezen. Als het Control al een onderliggend element van een ander besturingselement is, wordt het uit dat besturingselement verwijderd voordat het wordt toegevoegd aan een ander besturingselement.
Notities voor overnemers
Wanneer u Add(Control) overschrijft in een afgeleide klasse, moet u de methode van Add(Control) de basisklasse aanroepen om ervoor te zorgen dat het besturingselement wordt toegevoegd aan de verzameling.