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; }
[<System.ComponentModel.Browsable(false)>]
member this.Controls : System.Windows.Forms.Control.ControlCollection
Public ReadOnly Property Controls As Control.ControlCollection

속성 값

Control.ControlCollection

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

특성

예제

다음 코드 예제에서는 Control Control.ControlCollection 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 , Button 및 하나 이상의 컨트롤을 만들어야 RadioButton Form 합니다.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.ControlCollection Controls 클래스에서 파생 되는 폼의 속성에 할당 된의 멤버입니다 Control .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.

적용 대상

추가 정보