Form.ControlCollection.Add(Control) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt dem Formular ein Steuerelement hinzu.

public:
 override void Add(System::Windows::Forms::Control ^ value);

public override void Add (System.Windows.Forms.Control value);

public override void Add (System.Windows.Forms.Control? value);

override this.Add : System.Windows.Forms.Control -> unit

Public Overrides Sub Add (value As Control)

Parameter

value: Control

Das Control, das dem Formular hinzugefügt werden soll.

Ausnahmen

Exception

Einem übergeordneten MDI-Formular (Multiple Document Interface) dürfen keine Steuerelemente hinzugefügt werden.

Beispiele

Im folgenden Codebeispiel wird der Steuerelementsammlung eines Formulars ein TextBox Steuerelement hinzugefügt.Label Das Beispiel erfordert, dass ein Formular erstellt und benannt Form1wurde.

public:
   void AddMyControls()
   {
      TextBox^ textBox1 = gcnew TextBox;
      Label^ label1 = gcnew Label;
      
      // Initialize the controls and their bounds.
      label1->Text = "First Name";
      label1->Location = Point( 48, 48 );
      label1->Size = System::Drawing::Size( 104, 16 );
      textBox1->Text = "";
      textBox1->Location = Point(48,64);
      textBox1->Size = System::Drawing::Size( 104, 16 );
      
      // Add the TextBox control to the form's control collection.
      Controls->Add( textBox1 );
      // Add the Label control to the form's control collection.
      Controls->Add( label1 );
   }

public void AddMyControls()
 {
    TextBox textBox1 = new TextBox();
    Label label1 = new Label();
    
    // Initialize the controls and their bounds.
    label1.Text = "First Name";
    label1.Location = new Point(48,48);
    label1.Size = new Size (104, 16);
    textBox1.Text = "";
    textBox1.Location = new Point(48, 64);
    textBox1.Size = new Size(104,16);
 
    // Add the TextBox control to the form's control collection.
    Controls.Add(textBox1);
    // Add the Label control to the form's control collection.
    Controls.Add(label1);
 }

Public Sub AddMyControls()
    Dim textBox1 As New TextBox()
    Dim label1 As New Label()
    
    ' Initialize the controls and their bounds.
    label1.Text = "First Name"
    label1.Location = New Point(48, 48)
    label1.Size = New Size(104, 16)
    textBox1.Text = ""
    textBox1.Location = New Point(48, 64)
    textBox1.Size = New Size(104, 16)
    
    ' Add the TextBox control to the form's control collection.
    Controls.Add(textBox1)
    ' Add the Label control to the form's control collection.
    Controls.Add(label1)
End Sub

Hinweise

Sie können diese Methode verwenden, um dem Formular Steuerelemente hinzuzufügen. Wenn Sie dem Formular eine Gruppe bereits erstellter Steuerelemente hinzufügen möchten, verwenden Sie die Control.ControlCollection.AddRange Methode der Control.ControlCollection Klasse.

Gilt für

Siehe auch

Remove(Control)