Control.ControlCollection.Add(Control) 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

Source:

Control.ControlCollection.cs

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

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의 Control.ControlCollection a를 추가 Panel 합니다. 이 예제에서는 컨트롤과 컨트롤을 PanelButton 만들어야 합니다 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 수 있습니다.

메서드를 사용하여 Control 컬렉션에 새 AddRange 개체를 추가할 수도 있습니다.

이전에 추가한 Control 항목을 제거하려면 , Remove또는 RemoveAt 메서드를 Clear사용합니다.

메모

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

상속자 참고

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

추가 정보

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