Control.ControlCollection.Add(Control) メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

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

public:
 virtual void Add(System::Windows::Forms::Control ^ value);

public virtual void Add (System.Windows.Forms.Control? value);

abstract member Add : System.Windows.Forms.Control -> unit
override this.Add : System.Windows.Forms.Control -> unit

Public Overridable Sub Add (value As Control)

パラメーター

value

Control

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

例外

Exception

指定したコントロールがトップレベル コントロールであるか、または、このコントロールがコントロール コレクションに追加された場合は循環コントロール参照になります。

ArgumentException

value パラメーターに割り当てられたオブジェクトが Control ではありません。

例

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

   // 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.Controls.Add(textBox1);
}

' 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

注釈

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

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

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

注意

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

注意 (継承者)

派生クラスでオーバーライドする Add(Control) 場合は、必ず基底クラスの Add(Control) メソッドを呼び出して、コントロールがコレクションに追加されるようにしてください。

こちらもご覧ください

• Remove(Control)
• RemoveAt(Int32)
• AddRange(Control[])