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 из 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, Boolean) |
Извлекает индекс указанного дочернего элемента управления в коллекции элементов управления и при необходимости вызывает исключение, если указанный элемент управления не входит в коллекцию элементов управления. |
| GetChildIndex(Control) |
Извлекает индекс указанного дочернего элемента управления в коллекции элементов управления. |
| 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) |
Методы расширения
| Имя | Описание |
|---|---|
| AsParallel(IEnumerable) |
Включает параллелизацию запроса. |
| AsQueryable(IEnumerable) |
Преобразует IEnumerable в IQueryable. |
| Cast<TResult>(IEnumerable) |
Приведение элементов IEnumerable к указанному типу. |
| OfType<TResult>(IEnumerable) |
Фильтрует элементы IEnumerable на основе указанного типа. |