Form.ControlCollection Класс

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Представляет коллекцию элементов управления в форме.

public: ref class Form::ControlCollection : System::Windows::Forms::Control::ControlCollection

public class Form.ControlCollection : System.Windows.Forms.Control.ControlCollection

type Form.ControlCollection = class
    inherit Control.ControlCollection

Public Class Form.ControlCollection
Inherits Control.ControlCollection

Наследование

Object

ArrangedElementCollection

Control.ControlCollection

Form.ControlCollection

Примеры

В следующем примере кода элемент управления и Label добавляется TextBox в коллекцию элементов управления формы. В этом примере требуется, чтобы была создана форма с именем Form1.

public:
   void AddMyControls()
   {
      TextBox^ textBox1 = gcnew TextBox;
      Label^ label1 = gcnew Label;
      
      // Initialize the controls and their bounds.
      label1->Text = "First Name";
      label1->Location = Point( 48, 48 );
      label1->Size = System::Drawing::Size( 104, 16 );
      textBox1->Text = "";
      textBox1->Location = Point(48,64);
      textBox1->Size = System::Drawing::Size( 104, 16 );
      
      // Add the TextBox control to the form's control collection.
      Controls->Add( textBox1 );
      // Add the Label control to the form's control collection.
      Controls->Add( label1 );
   }

public void AddMyControls()
 {
    TextBox textBox1 = new TextBox();
    Label label1 = new Label();
    
    // Initialize the controls and their bounds.
    label1.Text = "First Name";
    label1.Location = new Point(48,48);
    label1.Size = new Size (104, 16);
    textBox1.Text = "";
    textBox1.Location = new Point(48, 64);
    textBox1.Size = new Size(104,16);
 
    // Add the TextBox control to the form's control collection.
    Controls.Add(textBox1);
    // Add the Label control to the form's control collection.
    Controls.Add(label1);
 }

Public Sub AddMyControls()
    Dim textBox1 As New TextBox()
    Dim label1 As New Label()
    
    ' Initialize the controls and their bounds.
    label1.Text = "First Name"
    label1.Location = New Point(48, 48)
    label1.Size = New Size(104, 16)
    textBox1.Text = ""
    textBox1.Location = New Point(48, 64)
    textBox1.Size = New Size(104, 16)
    
    ' Add the TextBox control to the form's control collection.
    Controls.Add(textBox1)
    ' Add the Label control to the form's control collection.
    Controls.Add(label1)
End Sub

Комментарии

Этот класс представляет коллекцию элементов управления, содержащихся в форме. Можно использовать метод для Add добавления элемента управления в форму, а Remove метод — для удаления элемента управления из формы. Коллекция элементов управления, представленная этим классом, не может быть создана без привязки к определенной форме. В результате нельзя создать несколько экземпляров этой коллекции элементов управления и использовать их для обмена с активной формой для предоставления различных макетов элементов управления.

Конструкторы

Form.ControlCollection(Form)

Инициализирует новый экземпляр класса Form.ControlCollection.

Свойства

Count	Возвращает количество элементов, содержащихся в коллекции. (Унаследовано от Control.ControlCollection)
IsReadOnly	Получает значение, указывающее, является ли этот объект коллекции доступным только для чтения. (Унаследовано от Control.ControlCollection)
Item[Int32]	Указывает объект Control, находящийся в заданном индексом местоположении в коллекции. (Унаследовано от Control.ControlCollection)
Item[String]	Указывает объект Control с заданным ключом в коллекции. (Унаследовано от Control.ControlCollection)
Owner	Получает элемент управления, владеющий данной коллекцией Control.ControlCollection. (Унаследовано от Control.ControlCollection)

Методы

Add(Control)	Добавляет элемент управления в форму.
AddRange(Control[])	Добавляет массив объектов управления в коллекцию. (Унаследовано от Control.ControlCollection)
Clear()	Удаляет все элементы управления из коллекции. (Унаследовано от Control.ControlCollection)
Contains(Control)	Определяет, является ли указанный элемент управления членом коллекции. (Унаследовано от Control.ControlCollection)
ContainsKey(String)	Определяет, содержится ли элемент с указанным ключом в коллекции Control.ControlCollection. (Унаследовано от Control.ControlCollection)
CopyTo(Array, Int32)	Копирует элементы коллекции в массив начиная с определенного индекса в массиве. (Унаследовано от Control.ControlCollection)
Equals(Object)	Указывает, равен ли текущий объект коллекции указанному объекту. (Унаследовано от Control.ControlCollection)
Find(String, Boolean)	Выполняет поиск элементов управления по их свойству Name и создает массив из всех элементов управления, которые соответствуют условиям поиска. (Унаследовано от Control.ControlCollection)
GetChildIndex(Control)	Извлекает индекс указанного дочернего элемента управления в коллекции элементов управления. (Унаследовано от Control.ControlCollection)
GetChildIndex(Control, Boolean)	Извлекает индекс указанного дочернего элемента управления в коллекции и при необходимости вызывает исключение, если указанный элемент управления не обнаружен в коллекции элементов управления. (Унаследовано от Control.ControlCollection)
GetEnumerator()	Извлекает ссылку на объект перечислителя, который используется для итерации по коллекции Control.ControlCollection. (Унаследовано от Control.ControlCollection)
GetHashCode()	Возвращает хэш-код данного экземпляра. (Унаследовано от Control.ControlCollection)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IndexOf(Control)	Извлекает индекс указанного элемента управления в коллекции элементов управления. (Унаследовано от Control.ControlCollection)
IndexOfKey(String)	Извлекает индекс первого вхождения заданного элемента в коллекции. (Унаследовано от Control.ControlCollection)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
Remove(Control)	Удаляет элемент управления из формы.
RemoveAt(Int32)	Удаляет элемент управления из коллекции по указанному расположению индекса. (Унаследовано от Control.ControlCollection)
RemoveByKey(String)	Удаляет дочерний элемент управления с указанным ключом. (Унаследовано от Control.ControlCollection)
SetChildIndex(Control, Int32)	Задает определенное значение индексу указанного дочернего элемента управления в коллекции. (Унаследовано от Control.ControlCollection)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Явные реализации интерфейса

ICloneable.Clone()	Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода. Описание этого члена см. в разделе Clone(). (Унаследовано от Control.ControlCollection)
ICollection.IsSynchronized	Описание этого элемента см. в свойстве IsSynchronized. (Унаследовано от ArrangedElementCollection)
ICollection.SyncRoot	Описание этого элемента см. в свойстве SyncRoot. (Унаследовано от ArrangedElementCollection)
IList.Add(Object)	Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода. Описание этого члена см. в разделе Add(Object). (Унаследовано от Control.ControlCollection)
IList.Clear()	Описание этого элемента содержится в методе Clear(). (Унаследовано от ArrangedElementCollection)
IList.IsFixedSize	Описание этого элемента см. в свойстве IsFixedSize. (Унаследовано от ArrangedElementCollection)
IList.Item[Int32]	Описание этого элемента см. в свойстве Item[Int32]. (Унаследовано от ArrangedElementCollection)
IList.Remove(Object)	Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода. Описание этого члена см. в разделе Remove(Object). (Унаследовано от Control.ControlCollection)
IList.RemoveAt(Int32)	Описание этого элемента содержится в методе RemoveAt(Int32). (Унаследовано от ArrangedElementCollection)

Методы расширения

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

• Control.ControlCollection