Control.Controls 속성

정의

컨트롤에 포함된 컨트롤의 컬렉션을 가져옵니다.Gets the collection of controls contained within the control.

public:
 property System::Windows::Forms::Control::ControlCollection ^ Controls { System::Windows::Forms::Control::ControlCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.Control.ControlCollection Controls { get; }
member this.Controls : System.Windows.Forms.Control.ControlCollection
Public ReadOnly Property Controls As Control.ControlCollection

속성 값

컨트롤에 포함된 컨트롤의 컬렉션을 나타내는 Control.ControlCollection입니다.A Control.ControlCollection representing the collection of controls contained within the control.

특성

예제

다음 코드 예제에서는 파생 클래스의 Control.ControlCollection에서 Control를 제거 하 고 컬렉션의 멤버인 경우 Panel 합니다.The following code example removes a Control from the Control.ControlCollection of the derived class Panel if it is a member of the collection. 이 예에서는 Panel, ButtonForm에서 하나 이상의 RadioButton 컨트롤을 만들어야 합니다.The example requires that you have created a Panel, a Button, and at least one RadioButton control on a Form. RadioButton 컨트롤이 Panel 컨트롤에 추가 되 고 Panel 컨트롤이 Form에 추가 됩니다.The RadioButton control(s) are added to the Panel control, and the Panel control added to the Form. 단추를 클릭 하면 removeButton 이라는 라디오 단추가 Control.ControlCollection에서 제거 됩니다.When the button is clicked, the radio button named removeButton is removed from the Control.ControlCollection.

   // Remove the RadioButton control if it exists.
private:
   void removeButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      if ( panel1->Controls->Contains( removeButton ) )
      {
         panel1->Controls->Remove( removeButton );
      }
   }
// Remove the RadioButton control if it exists.
private void removeButton_Click(object sender, System.EventArgs e)
{
   if(panel1.Controls.Contains(removeButton))
   {
      panel1.Controls.Remove(removeButton);
   }
}
' Remove the RadioButton control if it exists.
Private Sub RemoveButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles RemoveButton.Click
    If Panel1.Controls.Contains(RemoveButton) Then
        Panel1.Controls.Remove(RemoveButton)
    End If
End Sub

설명

Control은 컨트롤 컬렉션의 부모 역할을 할 수 있습니다.A Control can act as a parent to a collection of controls. 예를 들어 Form에 여러 컨트롤이 추가 될 때 각 컨트롤은 Control 클래스에서 파생 되는 폼의 Controls 속성에 할당 된 Control.ControlCollection의 멤버입니다.For example, when several controls are added to a Form, each of the controls is a member of the Control.ControlCollection assigned to the Controls property of the form, which is derived from the Control class.

Control.ControlCollection 클래스에서 제공 되는 메서드를 사용 하 여 Controls 속성에 할당 된 Control.ControlCollection의 컨트롤을 조작할 수 있습니다.You can manipulate the controls in the Control.ControlCollection assigned to the Controls property by using the methods available in the Control.ControlCollection class.

부모 컨트롤에 여러 컨트롤을 추가 하는 경우 추가할 컨트롤을 초기화 하기 전에 SuspendLayout 메서드를 호출 하는 것이 좋습니다.When adding several controls to a parent control, it is recommended that you call the SuspendLayout method before initializing the controls to be added. 부모 컨트롤에 컨트롤을 추가한 후 ResumeLayout 메서드를 호출 합니다.After adding the controls to the parent control, call the ResumeLayout method. 이렇게 하면 많은 컨트롤을 사용 하 여 애플리케이션의 성능을 향상 시킵니다.Doing so will increase the performance of applications with many controls.

중첩 된 컨트롤을 포함 하 여 폼의 모든 컨트롤을 반복 하려면 Controls 속성을 사용 합니다.Use the Controls property to iterate through all controls of a form, including nested controls. GetNextControl 메서드를 사용 하 여 탭 순서에서 이전 또는 다음 자식 컨트롤을 검색 합니다.Use the GetNextControl method to retrieve the previous or next child control in the tab order. ActiveControl 속성을 사용 하 여 컨테이너 컨트롤의 활성 컨트롤을 가져오거나 설정 합니다.Use the ActiveControl property to get or set the active control of a container control.

적용 대상

추가 정보