Control.Controls Control.Controls Control.Controls Control.Controls Property

정의

컨트롤에 포함된 컨트롤의 컬렉션을 가져옵니다.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 에서 합니다 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 대 한 control 권한를 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.

적용 대상

추가 정보