Control.ControlCollection.Add(Control) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したコントロールをコントロール コレクションに追加します。
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 -> unitPublic Overridable Sub Add (value As Control)パラメーター
例外
指定したコントロールがトップレベル コントロールであるか、または、このコントロールがコントロール コレクションに追加された場合は循環コントロール参照になります。
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) メソッドを呼び出して、コントロールがコレクションに追加されるようにしてください。
適用対象
こちらもご覧ください
.NET