Control.ControlCollection Класс

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

Control.ControlCollection.cs

Представляет коллекцию 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, Boolean)	Извлекает индекс указанного дочернего элемента управления в коллекции элементов управления и при необходимости вызывает исключение, если указанный элемент управления не входит в коллекцию элементов управления.
GetChildIndex(Control)	Извлекает индекс указанного дочернего элемента управления в коллекции элементов управления.
GetEnumerator()	Извлекает ссылку на объект перечислителя, используемый для итерации по объекту Control.ControlCollectionперечисления.
GetHashCode()	Возвращает хэш-код для этого экземпляра. (Унаследовано от ArrangedElementCollection)
IndexOf(Control)	Извлекает индекс указанного элемента управления в коллекции элементов управления.
IndexOfKey(String)	Извлекает индекс первого вхождения указанного элемента в коллекции.
Remove(Control)	Удаляет указанный элемент управления из коллекции элементов управления.
RemoveAt(Int32)	Удаляет элемент управления из коллекции элементов управления в указанном индексированном расположении.
RemoveByKey(String)	Удаляет дочерний элемент управления с указанным ключом.
SetChildIndex(Control, Int32)	Задает индекс указанного дочернего элемента управления в коллекции указанным значением индекса.

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

Имя	Описание
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