Control.ControlCollection.Add(Control) 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

지정된 컨트롤을 컨트롤 컬렉션에 추가합니다.

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입니다.

예외

Exception

지정된 컨트롤이 최상위 컨트롤이거나, 이 컨트롤이 컨트롤 컬렉션에 추가될 때 순환 컨트롤 참조가 발생하는 경우

ArgumentException

value 매개 변수에 할당된 개체가 Control이 아닌 경우

예제

다음 코드 예제 Control 에서는 파생 클래스Panel의 Control.ControlCollection 추가 합니다. 이 예제에서는 컨트롤과 컨트롤을 Panel Button 만들어야 합니다 Form. 단추를 클릭하면 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 항목을 제거하려면 , RemoveAt또는 Clear 메서드를 Remove사용합니다.

참고

A는 Control 한 번에 하나씩 Control.ControlCollection 만 할당할 수 있습니다. 이미 다른 컨트롤의 Control 자식인 경우 다른 컨트롤에 추가되기 전에 해당 컨트롤에서 제거됩니다.

상속자 참고

파생 클래스에서 재정의하는 Add(Control) 경우 기본 클래스의 Add(Control) 메서드를 호출하여 컨트롤이 컬렉션에 추가되도록 해야 합니다.

추가 정보

• Remove(Control)
• RemoveAt(Int32)
• AddRange(Control[])