Поделиться через


Control.ControlCollection Класс

Определение

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

public: ref class Control::ControlCollection : ICloneable, System::Collections::IList
public: ref class Control::ControlCollection : System::Windows::Forms::Layout::ArrangedElementCollection, ICloneable, System::Collections::IList
[System.ComponentModel.ListBindable(false)]
public class Control.ControlCollection : ICloneable, System.Collections.IList
[System.ComponentModel.ListBindable(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public 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
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable
[<System.ComponentModel.ListBindable(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
type Control.ControlCollection = class
    inherit ArrangedElementCollection
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable
[<System.ComponentModel.ListBindable(false)>]
type Control.ControlCollection = class
    inherit ArrangedElementCollection
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable
Public Class Control.ControlCollection
Implements ICloneable, IList
Public Class Control.ControlCollection
Inherits ArrangedElementCollection
Implements ICloneable, IList
Наследование
Control.ControlCollection
Наследование
Control.ControlCollection
Производный
Атрибуты
Реализации

Примеры

В следующем примере кода удаляется 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

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

Count

Получает количество элементов коллекции.

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

Получает значение, указывающее, является ли этот объект коллекции доступным только для чтения.

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)

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

CopyTo(Array, Int32)

Копирует все содержимое этой коллекции в совместимый одномерный массив Array, начиная с указанного индекса конечного массива.

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

Указывает, равен ли текущий объект коллекции указанному объекту.

Equals(Object)

Определяет, равны ли два экземпляра ArrangedElementCollection.

(Унаследовано от ArrangedElementCollection)
Find(String, Boolean)

Выполняет поиск элементов управления по их свойству Name и создает массив из всех элементов управления, которые соответствуют условиям поиска.

GetChildIndex(Control)

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

GetChildIndex(Control, Boolean)

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

GetEnumerator()

Извлекает ссылку на объект перечислителя, который используется для итерации по коллекции Control.ControlCollection.

GetHashCode()

Возвращает хэш-код данного экземпляра.

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)

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

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

IList.Contains(Object)

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

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

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

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

IList.IndexOf(Object)

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

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

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

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

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)

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

Cast<TResult>(IEnumerable)

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

OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.

AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.

AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.

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

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