Control.ControlCollection.Remove(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 verwijdert u het opgegeven besturingselement uit de verzameling besturingselementen.
public:
virtual void Remove(System::Windows::Forms::Control ^ value);public virtual void Remove(System.Windows.Forms.Control value);abstract member Remove : System.Windows.Forms.Control -> unit
override this.Remove : System.Windows.Forms.Control -> unitPublic Overridable Sub Remove (value As Control)Parameters
- value
- Control
De Control te verwijderen uit de Control.ControlCollection.
Voorbeelden
In het volgende codevoorbeeld wordt een Control van de Control.ControlCollection afgeleide klasse Panel verwijderd als deze lid is van de verzameling. Voor het voorbeeld is vereist dat u een Panel, a Buttonen een of meer RadioButton besturingselementen op een Form. De RadioButton besturingselementen worden toegevoegd aan het Panel besturingselement en het Panel besturingselement wordt toegevoegd aan het Formbesturingselement. Wanneer op de knop wordt geklikt, wordt het keuzerondje met de naam radioButton2 verwijderd uit de Control.ControlCollectionknop .
// Remove the RadioButton control if it exists.
private:
void removeButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
if ( panel1->Controls->Contains( removeButton ) )
{
panel1->Controls->Remove( removeButton );
}
}
// Remove the RadioButton control if it exists.
private void removeButton_Click(object sender, System.EventArgs e)
{
if(panel1.Controls.Contains(removeButton))
{
panel1.Controls.Remove(removeButton);
}
}
' Remove the RadioButton control if it exists.
Private Sub RemoveButton_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles RemoveButton.Click
If Panel1.Controls.Contains(RemoveButton) Then
Panel1.Controls.Remove(RemoveButton)
End If
End Sub
Opmerkingen
Wanneer een Control van de besturingselementenverzameling wordt verwijderd, worden alle volgende besturingselementen één positie in de verzameling verplaatst.
U kunt ook een Control met behulp van de RemoveAt methode verwijderen of alle besturingselementen verwijderen met behulp van de Clear methode.
Als u nieuwe Control objecten wilt toevoegen aan de verzameling, gebruikt u de Add of AddRange methoden.
Notities voor overnemers
Wanneer u Remove(Control) overschrijft in een afgeleide klasse, moet u de methode van Remove(Control) de basisklasse aanroepen om ervoor te zorgen dat het besturingselement uit de verzameling wordt verwijderd.