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 управления 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.

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

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