Control.ControlCollection.Add(Control) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Lägger till den angivna kontrollen i kontrollsamlingen.
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)Parametrar
Undantag
Den angivna kontrollen är en kontroll på den översta nivån, eller så skulle en cirkelkontrollreferens resultera om den här kontrollen lades till i kontrollsamlingen.
Objektet som tilldelats parametern value är inte en Control.
Exempel
I följande kodexempel läggs en Control till i Control.ControlCollection den härledda klassen Panel. Exemplet kräver att du har skapat en Panel kontroll och en Button kontroll på en Form. När knappen klickas läggs en TextBox kontroll till i panelens 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
Kommentarer
Med Add metoden kan du lägga Control till objekt i slutet av kontrollsamlingen.
Du kan också lägga till nya Control objekt i samlingen med hjälp AddRange av metoden .
Om du vill ta bort en Control som du tidigare har lagt till använder du Removemetoderna , RemoveAteller Clear .
Note
A Control kan bara tilldelas till en Control.ControlCollection i taget. Om är redan underordnad Control en annan kontroll tas den bort från den kontrollen innan den läggs till i en annan kontroll.
Anteckningar till arvingar
När du Add(Control) åsidosätter i en härledd klass måste du anropa basklassens Add(Control) metod för att säkerställa att kontrollen läggs till i samlingen.
