Control.ControlCollection.AddRange メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Control.ControlCollection.AddRange メソッド

コレクションにコントロールオブジェクトの配列を追加します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub AddRange
 ( _
    controls As Control() _
)

Visual Basic (使用法)

Dim instance As ControlCollection
Dim controls As Control()

instance.AddRange(controls)

public virtual void AddRange (
    Control[] controls
)

C++

public:
virtual void AddRange (
    array<Control^>^ controls
)

public void AddRange (
    Control[] controls
)

JScript

public function AddRange (
    controls : Control[]
)

パラメータ

controls: コレクションに追加する Control オブジェクトの配列。

解説

controls 配列に格納されている Control オブジェクトが、コレクションの末尾に追加されます。

Add メソッドを使用して個別の Control を手動でコレクションに追加するのではなく、AddRange メソッドを使用して Control オブジェクトのグループをすばやくコレクションに追加できます。

以前追加した Control を削除するには、Remove、RemoveAt、Clear の各メソッドを使用します。

継承時の注意 派生クラスで AddRange をオーバーライドする場合は、基本クラスの AddRange メソッドを呼び出して、確実にコントロールがコレクションに追加されるようにしてください。

使用例

2 つの Control オブジェクトを派生クラス Panel の Control.ControlCollection に追加するコード例を次に示します。この例では、Form 上に Panel コントロールと Button コントロールが作成されている必要があります。ボタンがクリックされると、2 つの RadioButton コントロールがパネルの Control.ControlCollection に追加されます。

Visual Basic

' 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

// 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});
}

C++

   // 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.set_Text("radioAddButton");
    radioRemoveButton.set_Text("radioRemoveButton");

    // Set the appropriate location of radioRemoveButton.
    radioRemoveButton.set_Location(new System.Drawing.Point(radioAddButton.
        get_Location().get_X(), radioAddButton.get_Location().get_Y() 
        + radioAddButton.get_Height()));

    //Add the controls to the Panel.
    panel1.get_Controls().AddRange(new Control[] { radioAddButton,
 
        radioRemoveButton });
} //addRangeButton_Click