Control.ControlCollection.AddRange(Control[]) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет массив объектов управления в коллекцию.
public:
virtual void AddRange(cli::array <System::Windows::Forms::Control ^> ^ controls);
public:
virtual void AddRange(... cli::array <System::Windows::Forms::Control ^> ^ controls);
public virtual void AddRange (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 (controls As Control())
Public Overridable Sub AddRange (ParamArray controls As Control())
Параметры
Примеры
В следующем примере кода добавляются два Control объекта в Control.ControlCollection объект производного класса Panel. В этом примере требуется, чтобы вы создали Panel элемент управления и Button элемент управления в Form. При нажатии кнопки в панель Control.ControlCollectionдобавляются два RadioButton элемента управления .
// 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
Комментарии
Объекты Control , содержащиеся в массиве controls
, добавляются в конец коллекции.
Метод можно использовать AddRange для быстрого добавления группы Control объектов в коллекцию, а не добавления каждого из них Control в коллекцию вручную с помощью Add метода .
Чтобы удалить ранее добавленный Control объект , используйте методы Remove, RemoveAtили Clear .
Примечания для тех, кто наследует этот метод
При переопределении AddRange(Control[]) в производном классе обязательно вызовите метод базового класса AddRange(Control[]) , чтобы убедиться, что элементы управления добавлены в коллекцию.