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
- Наследование
- Наследование
- Атрибуты
Примеры
В следующем примере кода добавляется 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 на основе указанного типа. |