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

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

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

Control.ControlCollection.Add メソッド

指定したコントロールをコントロールコレクションに追加します。

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

Visual Basic (宣言)

Public Overridable Sub Add
 ( _
    value As Control _
)

Visual Basic (使用法)

Dim instance As ControlCollection
Dim value As Control

instance.Add(value)

public virtual void Add (
    Control value
)

C++

public:
virtual void Add (
    Control^ value
)

public void Add (
    Control value
)

JScript

public function Add (
    value : Control
)

パラメータ

value: コントロールコレクションに追加する Control。

例外

例外の種類	条件
Exception	指定したコントロールがトップレベルコントロールであるか、または、このコントロールがコントロールコレクションに追加された場合は循環コントロール参照になります。
ArgumentException	value パラメータに割り当てられたオブジェクトが Control ではありません。

解説

Add メソッドを使用すると、Control オブジェクトをコントロールコレクションの末尾に追加できます。

AddRange メソッドを使用すると、新しい Control オブジェクトもコレクションに追加できます。

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

メモ
Control は、一度に 1 つの Control.ControlCollection にだけ割り当てることができます。Control が既に他のコントロールの子コントロールである場合は、別のコントロールに追加される前にそのコントロールから削除されます。

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

使用例

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

Visual Basic

' Create a TextBox to add to the Panel.
Dim TextBox1 As TextBox = New
 TextBox()

' Add controls to the Panel using the Add method.
Private Sub AddButton_Click(ByVal
 sender As System.Object, _
    ByVal e As System.EventArgs) Handles
 AddButton.Click
    Panel1.Controls.Add(TextBox1)
End Sub

// Create a TextBox to add to the Panel.
private TextBox textBox1 = new TextBox();

// Add controls to the Panel using the Add method.
private void addButton_Click(object sender,
 System.EventArgs e)
{
   panel1.Controls.Add(textBox1);
}

C++

   // Create a TextBox to add to the Panel.
private:
   TextBox^ textBox1;

   // Add controls to the Panel using the Add method.
   void addButton_Click( Object^ /*sender*/, System::EventArgs^
 /*e*/ )
   {
      textBox1 = gcnew TextBox;
      panel1->Controls->Add( textBox1 );
   }

// Create a TextBox to add to the Panel.
private TextBox textBox1 = new TextBox();

// Add controls to the Panel using the Add method.
private void addButton_Click(Object sender,
 System.EventArgs e)
{
    panel1.get_Controls().Add(textBox1);
} //addButton_Click