Control.ControlCollection.AddRange(Control[]) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fügt der Auflistung ein Array von Steuerelementobjekten hinzu.

public:
 virtual void AddRange(cli::array <System::Windows::Forms::Control ^> ^ controls);

public virtual void AddRange (System.Windows.Forms.Control[] controls);

abstract member AddRange : System.Windows.Forms.Control[] -> unit
override this.AddRange : System.Windows.Forms.Control[] -> unit

Public Overridable Sub AddRange (controls As Control())

Parameter

controls

Control[]

Ein Array von Control-Objekten, die der Auflistung hinzugefügt werden sollen.

Beispiele

Im folgenden Codebeispiel werden der abgeleiteten Klasse Panelzwei Control Objekte Control.ControlCollection hinzugefügt. Das Beispiel erfordert, dass Sie ein Steuerelement und ein Panel Button Steuerelement auf einem FormSteuerelement erstellt haben. Wenn die Schaltfläche geklickt wird, werden zwei RadioButton Steuerelemente dem Bereich Control.ControlCollectionhinzugefügt.

   // Create two RadioButtons to add to the Panel.
private:
   RadioButton^ radioAddButton;
   RadioButton^ radioRemoveButton;

   // Add controls to the Panel using the AddRange method.
   void addRangeButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      radioAddButton = gcnew RadioButton;
      radioRemoveButton = gcnew RadioButton;
      
      // Set the Text the RadioButtons will display.
      radioAddButton->Text = "radioAddButton";
      radioRemoveButton->Text = "radioRemoveButton";
      
      // Set the appropriate location of radioRemoveButton.
      radioRemoveButton->Location = System::Drawing::Point( radioAddButton->Location.X, radioAddButton->Location.Y + radioAddButton->Height );
      
      //Add the controls to the Panel.
      array<Control^>^controlArray = {radioAddButton,radioRemoveButton};
      panel1->Controls->AddRange( controlArray );
   }

// Create two RadioButtons to add to the Panel.
private RadioButton radioAddButton = new RadioButton();
private RadioButton radioRemoveButton = new RadioButton();

// Add controls to the Panel using the AddRange method.
private void addRangeButton_Click(object sender, System.EventArgs e)
{
   // Set the Text the RadioButtons will display.
   radioAddButton.Text = "radioAddButton";
   radioRemoveButton.Text = "radioRemoveButton";
            
   // Set the appropriate location of radioRemoveButton.
   radioRemoveButton.Location = new System.Drawing.Point(
     radioAddButton.Location.X, 
     radioAddButton.Location.Y + radioAddButton.Height);
            
   //Add the controls to the Panel.
   panel1.Controls.AddRange(new Control[]{radioAddButton, radioRemoveButton});
}

' Create two RadioButtons to add to the Panel.
Dim RadioAddButton As RadioButton = New RadioButton()
Dim RadioAddRangeButton As RadioButton = New RadioButton()

' Add controls to the Panel using the AddRange method.
Private Sub AddRangeButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles AddRangeButton.Click
    ' Set the Text the RadioButtons will display.
    RadioAddButton.Text = "RadioAddButton"
    RadioAddRangeButton.Text = "RadioAddRangeButton"

    ' Set the appropriate location of RadioAddRangeButton.
    RadioAddRangeButton.Location = New System.Drawing.Point( _
    RadioAddButton.Location.X, _
    RadioAddButton.Location.Y + RadioAddButton.Height)

    ' Add the controls to the Panel.
    Panel1.Controls.AddRange(New Control() {RadioAddButton, RadioAddRangeButton})
End Sub

Hinweise

Die objekte, die Control im Array enthalten sind, werden am Ende der controls Auflistung angefügt.

Sie können die AddRange Methode verwenden, um schnell eine Gruppe von Control Objekten zur Auflistung hinzuzufügen, anstatt jede Control der Auflistung mithilfe der Add Methode manuell hinzuzufügen.

Verwenden Sie zum Entfernen eines Control zuvor hinzugefügten Typs die RemoveMethoden , RemoveAtoder Clear verwenden Sie diese.

Hinweise für Vererber

Wenn sie in einer abgeleiteten Klasse außer Kraft AddRange(Control[]) gesetzt werden, müssen Sie die Methode der Basisklasse AddRange(Control[]) aufrufen, um sicherzustellen, dass die Steuerelemente der Auflistung hinzugefügt werden.

Siehe auch

• Add(Control)