Control.ControlCollection.Add(Control) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Dodaje określoną kontrolkę do kolekcji kontrolek.
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)Parametry
Wyjątki
Określona kontrolka jest kontrolką najwyższego poziomu lub odwołanie do kontrolki cyklicznej spowodowałoby dodanie tej kontrolki do kolekcji kontrolek.
Obiekt przypisany do parametru value nie jest .Control
Przykłady
Poniższy przykład kodu dodaje element Control do Control.ControlCollection klasy Panelpochodnej . Przykład wymaga utworzenia kontrolki Panel i Button kontrolki w obiekcie Form. Po kliknięciu TextBox przycisku do panelu zostanie dodana kontrolka 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
Uwagi
Metoda Add umożliwia dodawanie Control obiektów na końcu kolekcji kontrolek.
Możesz również dodać nowe Control obiekty do kolekcji przy użyciu AddRange metody .
Aby usunąć wcześniej dodany element Control , użyj Removemetod , RemoveAtlub Clear .
Note
Obiekt Control można przypisać tylko do jednego Control.ControlCollection naraz. Control Jeśli element jest już elementem podrzędnym innej kontrolki, zostanie usunięty z tej kontrolki, zanim zostanie dodany do innej kontrolki.
Notatki dotyczące dziedziczenia
Podczas zastępowania Add(Control) klasy pochodnej należy wywołać metodę klasy Add(Control) bazowej, aby upewnić się, że kontrolka jest dodawana do kolekcji.
