次の方法で共有

Control.ControlCollection.Add メソッド

  • [アーティクル]

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

Public Overridable Sub Add( _
   ByVal value As Control _)
[C#]
public virtual void Add(Controlvalue);
[C++]
public: virtual 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 メソッドを呼び出して、確実にコントロールがコレクションに追加されるようにしてください。

使用例

[Visual Basic, C#, C++] Control を派生クラス Panel の Control.ControlCollection に追加する例を次に示します。この例では、 Form 上に Panel コントロールと Button コントロールを作成済みであることを前提にしています。ボタンがクリックされると、 TextBox コントロールがパネルの Control.ControlCollection に追加されます。

 
' 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

[C#] 
// 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 = new TextBox();
    panel1->Controls->Add(textBox1);
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

Control.ControlCollection クラス | Control.ControlCollection メンバ | System.Windows.Forms 名前空間 | Remove | RemoveAt | AddRange