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 из 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.

Применяется к

Дополнительно