Control.ControlCollection.Add(Control) Control.ControlCollection.Add(Control) Control.ControlCollection.Add(Control) Control.ControlCollection.Add(Control) Method

定義

指定したコントロールをコントロール コレクションに追加します。Adds the specified control to the control collection.

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 Control Control

コントロール コレクションに追加する ControlThe Control to add to the control collection.

例外

指定したコントロールがトップレベル コントロールであるか、または、このコントロールがコントロール コレクションに追加された場合は循環コントロール参照になります。The specified control is a top-level control, or a circular control reference would result if this control were added to the control collection.

value パラメーターに割り当てられたオブジェクトが Control ではありません。The object assigned to the value parameter is not a Control.

次のコード例では、派生クラス Panel の @no__t に Control を追加します。The following code example adds a Control to the Control.ControlCollection of the derived class Panel. この例では、Form で @no__t 0 コントロールと @no__t 1 コントロールを作成しておく必要があります。The example requires that you have created a Panel control and a Button control on a Form. このボタンをクリックすると、@no__t 0 コントロールがパネルの Control.ControlCollection に追加されます。When the button is clicked, a TextBox control is added to the panel's 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

注釈

@No__t-0 メソッドを使用すると、Control のオブジェクトをコントロールコレクションの末尾に追加できます。The Add method allows you to add Control objects to the end of the control collection.

@No__t-1 メソッドを使用して、新しい Control オブジェクトをコレクションに追加することもできます。You can also add new Control objects to the collection by using the AddRange method.

以前に追加した @no__t 0 を削除するには、RemoveRemoveAt、または Clear の各メソッドを使用します。To remove a Control that you previously added, use the Remove, RemoveAt, or Clear methods.

注意

@No__t 0 は、一度に1つの @no__t にのみ割り当てることができます。A Control can only be assigned to one Control.ControlCollection at a time. @No__t-0 が既に別のコントロールの子になっている場合は、別のコントロールに追加される前に、そのコントロールから削除されます。If the Control is already a child of another control it is removed from that control before it is added to another control.

注意 (継承者)

派生クラスで @no__t 0 をオーバーライドする場合は、必ず基底クラスの @no__t メソッドを呼び出して、コントロールが確実にコレクションに追加されるようにしてください。When overriding Add(Control) in a derived class, be sure to call the base class's Add(Control) method to ensure that the control is added to the collection.

適用対象

こちらもご覧ください