Control.ControlCollection Класс

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Представляет коллекцию объектов Control.

public: ref class Control::ControlCollection : System::Windows::Forms::Layout::ArrangedElementCollection, ICloneable, System::Collections::IList

[System.ComponentModel.ListBindable(false)]
public class Control.ControlCollection : System.Windows.Forms.Layout.ArrangedElementCollection, ICloneable, System.Collections.IList

[<System.ComponentModel.ListBindable(false)>]
type Control.ControlCollection = class
    inherit ArrangedElementCollection
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

Public Class Control.ControlCollection
Inherits ArrangedElementCollection
Implements ICloneable, IList

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

Object

ArrangedElementCollection

Control.ControlCollection

Производный

System.Windows.Forms.DataGridView.DataGridViewControlCollection

System.Windows.Forms.Form.ControlCollection

System.Windows.Forms.MdiClient.ControlCollection

System.Windows.Forms.TabControl.ControlCollection

System.Windows.Forms.TableLayoutControlCollection

System.Windows.Forms.TabPage.TabPageControlCollection

Атрибуты

ListBindableAttribute

Реализации

ICollection IEnumerable IList ICloneable

Примеры

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

Комментарии

Методы Add, Removeи RemoveAt позволяют добавлять и удалять отдельные элементы управления из коллекции. Вы также можете использовать методы AddRange или Clear для добавления или удаления всех элементов управления из коллекции.

Можно определить, является ли Control элементом коллекции, передав элемент управления в Contains метод . Чтобы получить значение индекса расположения Control объекта в коллекции, передайте элемент управления в IndexOf метод . Коллекцию можно скопировать в массив, вызвав CopyTo метод .

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

Control.ControlCollection(Control)

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

Свойства

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

Методы

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

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

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

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

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

• Control
• IList