Control.ControlCollection.Add(Control) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Aggiunge il controllo specificato alla raccolta di controlli.
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)Parametri
Eccezioni
Il controllo specificato è un controllo di primo livello o un riferimento a un controllo circolare determina se questo controllo è stato aggiunto alla raccolta di controlli.
L'oggetto value assegnato al parametro non è un oggetto Control.
Esempio
Nell'esempio di codice seguente viene aggiunto un Control oggetto all'oggetto Control.ControlCollection della classe Panelderivata . L'esempio richiede che sia stato creato un Panel controllo e un Button controllo in un oggetto Form. Quando si fa clic sul pulsante, al pannello TextBoxviene aggiunto un Control.ControlCollection controllo .
// 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
Commenti
Il Add metodo consente di aggiungere Control oggetti alla fine dell'insieme di controlli.
È anche possibile aggiungere nuovi Control oggetti all'insieme usando il AddRange metodo .
Per rimuovere un oggetto Control aggiunto in precedenza, usare i Removemetodi , RemoveAto Clear .
Note
Un Control oggetto può essere assegnato solo a uno Control.ControlCollection alla volta. Se l'oggetto Control è già figlio di un altro controllo, viene rimosso da tale controllo prima che venga aggiunto a un altro controllo.
Note per gli eredi
Quando si esegue l'override Add(Control) in una classe derivata, assicurarsi di chiamare il metodo della classe di Add(Control) base per assicurarsi che il controllo venga aggiunto alla raccolta.
