Control.Controls Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

Control.cs

Возвращает коллекцию элементов управления, содержащихся в элементе управления.

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 коллекцию элементов управления, содержащихся в элементе управления.

Атрибуты

BrowsableAttribute

Примеры

В следующем примере кода удаляется Control из Control.ControlCollection производного класса Panel , если он является членом коллекции. В примере требуется, чтобы вы создали Panelэлемент управления , а Buttonтакже хотя бы один RadioButton элемент управления Form. Элементы RadioButton управления добавляются в Panel элемент управления, а Panel элемент управления добавляется в элемент Formуправления. При нажатии кнопки из него removeButton удаляется переключатель.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 может выступать в качестве родительского элемента управления. Например, при добавлении Formнескольких элементов управления в элемент управления каждый из элементов управления является членом Control.ControlCollectionControls назначенного свойству формы, которое является производным от Control класса.

Вы можете управлять элементами управления, Control.ControlCollection назначенными Controls свойству, с помощью методов, доступных в Control.ControlCollection классе.

При добавлении нескольких элементов управления в родительский элемент управления рекомендуется вызвать SuspendLayout метод перед инициализацией элементов управления, которые необходимо добавить. После добавления элементов управления в родительский элемент управления вызовите ResumeLayout метод. Это приведет к повышению производительности приложений с большим количеством элементов управления.

Controls Используйте свойство для итерации всех элементов управления формы, включая вложенные элементы управления. GetNextControl Используйте метод для получения предыдущего или следующего дочернего элемента управления в порядке табуляции. ActiveControl Используйте свойство, чтобы получить или задать активный элемент управления контейнером.

См. также раздел

• Control.ControlCollection
• CreateControlsInstance()
• SuspendLayout()
• ResumeLayout()