다음을 통해 공유


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이 아닌 경우

예제

다음 코드 예제 Control 에서는 파생 클래스PanelControl.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) 메서드를 호출하여 컨트롤이 컬렉션에 추가되도록 해야 합니다.

적용 대상

추가 정보