共用方式為


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

範例

下列程式碼範例會將 加入 ControlControl.ControlCollection 至衍生類別 Panel 的 。 此範例會要求您已在 上 Form 建立 Panel 控制項和 Button 控制項。 按一下按鈕時, 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 至控制項集合的結尾。

您也可以使用 AddRange 方法,將新 Control 物件新增至集合。

若要移除您先前新增的 Control ,請使用 RemoveRemoveAtClear 方法。

注意

Control一次只能指派給一個 Control.ControlCollectionControl如果 已經是另一個控制項的子系,則會先從該控制項中移除,再將其新增至另一個控制項。

給繼承者的注意事項

在衍生類別中覆 Add(Control) 寫時,請務必呼叫基類 Add(Control) 的 方法,以確保控制項已加入集合中。

適用於

另請參閱