Form.ControlCollection Класс

Определение

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

public: ref class Form::ControlCollection : System::Windows::Forms::Control::ControlCollection
public class Form.ControlCollection : System.Windows.Forms.Control.ControlCollection
[System.Runtime.InteropServices.ComVisible(false)]
public class Form.ControlCollection : System.Windows.Forms.Control.ControlCollection
type Form.ControlCollection = class
    inherit Control.ControlCollection
[<System.Runtime.InteropServices.ComVisible(false)>]
type Form.ControlCollection = class
    inherit Control.ControlCollection
Public Class Form.ControlCollection
Inherits Control.ControlCollection
Наследование
Form.ControlCollection
Наследование
Атрибуты

Примеры

В следующем примере кода добавляется TextBox и Label элемент управления в коллекцию элементов управления формы. В примере требуется, чтобы форма была создана и названа 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, Boolean)

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

(Унаследовано от Control.ControlCollection)
GetChildIndex(Control)

Извлекает индекс указанного дочернего элемента управления в коллекции элементов управления.

(Унаследовано от 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.Contains(Object)

Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода.

Описание этого элемента см. в разделе Contains(Object).

(Унаследовано от Control.ControlCollection)
IList.IndexOf(Object)

Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода.

Описание этого элемента см. в разделе IndexOf(Object).

(Унаследовано от Control.ControlCollection)
IList.Insert(Int32, Object)

Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода.

Описание этого элемента см. в разделе Insert(Int32, Object).

(Унаследовано от Control.ControlCollection)
IList.IsFixedSize

Описание этого элемента см. в свойстве IsFixedSize .

(Унаследовано от ArrangedElementCollection)
IList.Item[Int32]

Описание этого элемента см. в свойстве Item[Int32] .

(Унаследовано от ArrangedElementCollection)
IList.Remove(Object)

Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода.

Описание этого элемента см. в разделе Remove(Object).

(Унаследовано от Control.ControlCollection)
IList.RemoveAt(Int32)

Описание этого элемента см. в описании RemoveAt(Int32) метода.

(Унаследовано от ArrangedElementCollection)

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

Имя Описание
AsParallel(IEnumerable)

Включает параллелизацию запроса.

AsQueryable(IEnumerable)

Преобразует IEnumerable в IQueryable.

Cast<TResult>(IEnumerable)

Приведение элементов IEnumerable к указанному типу.

OfType<TResult>(IEnumerable)

Фильтрует элементы IEnumerable на основе указанного типа.

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

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