次の方法で共有


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

定義

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

public:
 virtual void Add(System::Windows::Forms::Control ^ value);
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

例外

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

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

次のコード例では、派生クラス の に Control.ControlCollection を追加ControlしますPanel。 この例では、 にコントロールとコントロールFormPanelButton作成している必要があります。 ボタンがクリックされると、 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) メソッドを呼び出して、コントロールがコレクションに追加されるようにしてください。

適用対象

こちらもご覧ください