Control.ControlCollection.AddRange(Control[]) Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

Control.ControlCollection.cs

Aggiunge una matrice di oggetti controllo all'insieme.

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

public virtual void AddRange (params 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 (ParamArray controls As Control())

Parametri

controls

Control[]

Matrice di oggetti Control da aggiungere alla raccolta.

Esempio

Nell'esempio di codice seguente vengono aggiunti due Control oggetti all'oggetto Control.ControlCollection della classe Panelderivata. L'esempio richiede che sia stato creato un Panel controllo e un Button controllo in un Formoggetto . Quando si fa clic sul pulsante, vengono aggiunti due RadioButton controlli al pannello.Control.ControlCollection

   // 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

Commenti

Gli Control oggetti contenuti nella matrice vengono aggiunti alla fine dell'insieme controls .

È possibile usare il AddRange metodo per aggiungere rapidamente un gruppo di Control oggetti alla raccolta anziché aggiungerli Control manualmente alla raccolta usando il Add metodo .

Per rimuovere un oggetto Control aggiunto in precedenza, usare i Removemetodi , RemoveAto Clear .

Note per gli eredi

Quando si esegue l'override AddRange(Control[]) in una classe derivata, assicurarsi di chiamare il metodo della AddRange(Control[]) classe base per assicurarsi che i controlli vengano aggiunti alla raccolta.

Vedi anche

• Add(Control)