Form.ControlCollection Form.ControlCollection Form.ControlCollection Form.ControlCollection Class

Definition

Represents a collection of controls on the form.

public: ref 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
Public Class Form.ControlCollection
Inherits Control.ControlCollection
Inheritance
Form.ControlCollectionForm.ControlCollectionForm.ControlCollectionForm.ControlCollection
Attributes

Examples

The following code example adds a TextBox and Label control to the control collection of a form. The example requires that a form has been created and named 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 'AddMyControls

Remarks

This class represents the collection of controls contained within a form. You can use the Add method to add a control to the form and the Remove method to remove the control from the form. The control collection represented by this class cannot be created without binding it to a specific form. As a result, you cannot create multiple instances of this control collection and interchange them with an active form to provide different control layouts.

Constructors

Form.ControlCollection(Form) Form.ControlCollection(Form) Form.ControlCollection(Form) Form.ControlCollection(Form)

Initializes a new instance of the Form.ControlCollection class.

Methods

Add(Control) Add(Control) Add(Control) Add(Control)

Adds a control to the form.

AddRange(Control[]) AddRange(Control[]) AddRange(Control[]) AddRange(Control[])

Adds an array of control objects to the collection.

(Inherited from Control.ControlCollection)
Clear() Clear() Clear() Clear()

Removes all controls from the collection.

(Inherited from Control.ControlCollection)
Contains(Control) Contains(Control) Contains(Control) Contains(Control)

Determines whether the specified control is a member of the collection.

(Inherited from Control.ControlCollection)
ContainsKey(String) ContainsKey(String) ContainsKey(String) ContainsKey(String)

Determines whether the Control.ControlCollection contains an item with the specified key.

(Inherited from Control.ControlCollection)
CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Copies the elements of the collection to an array, starting at a particular array index.

(Inherited from Control.ControlCollection)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Specifies whether the current collection object and the specified object are equal.

(Inherited from Control.ControlCollection)
Find(String, Boolean) Find(String, Boolean) Find(String, Boolean) Find(String, Boolean)

Searches for controls by their Name property and builds an array of all the controls that match.

(Inherited from Control.ControlCollection)
GetChildIndex(Control) GetChildIndex(Control) GetChildIndex(Control) GetChildIndex(Control)

Retrieves the index of the specified child control within the control collection.

(Inherited from Control.ControlCollection)
GetChildIndex(Control, Boolean) GetChildIndex(Control, Boolean) GetChildIndex(Control, Boolean) GetChildIndex(Control, Boolean)

Retrieves the index of the specified child control within the control collection, and optionally raises an exception if the specified control is not within the control collection.

(Inherited from Control.ControlCollection)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Retrieves a reference to an enumerator object that is used to iterate over a Control.ControlCollection.

(Inherited from Control.ControlCollection)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Returns the hash code for this instance.

(Inherited from Control.ControlCollection)
GetType() GetType() GetType() GetType()

Gets the Type of the current instance.

(Inherited from Object)
IndexOf(Control) IndexOf(Control) IndexOf(Control) IndexOf(Control)

Retrieves the index of the specified control in the control collection.

(Inherited from Control.ControlCollection)
IndexOfKey(String) IndexOfKey(String) IndexOfKey(String) IndexOfKey(String)

Retrieves the index of the first occurrence of the specified item within the collection.

(Inherited from Control.ControlCollection)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(Control) Remove(Control) Remove(Control) Remove(Control)

Removes a control from the form.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Removes a control from the control collection at the specified indexed location.

(Inherited from Control.ControlCollection)
RemoveByKey(String) RemoveByKey(String) RemoveByKey(String) RemoveByKey(String)

Removes the child control with the specified key.

(Inherited from Control.ControlCollection)
SetChildIndex(Control, Int32) SetChildIndex(Control, Int32) SetChildIndex(Control, Int32) SetChildIndex(Control, Int32)

Sets the index of the specified child control in the collection to the specified index value.

(Inherited from Control.ControlCollection)
ToString() ToString() ToString() ToString()

Returns a string that represents the current object.

(Inherited from Object)

Properties

Count Count Count Count

Gets the number of elements contained in the collection.

(Inherited from Control.ControlCollection)
IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Gets a value that indicates whether this collection object is read-only.

(Inherited from Control.ControlCollection)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Indicates the Control at the specified indexed location in the collection.

(Inherited from Control.ControlCollection)
Item[String] Item[String] Item[String] Item[String]

Indicates a Control with the specified key in the collection.

(Inherited from Control.ControlCollection)
Owner Owner Owner Owner

Gets the control that owns this Control.ControlCollection.

(Inherited from Control.ControlCollection)

Explicit Interface Implementations

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

For a description of this member, see Clone().

(Inherited from Control.ControlCollection)
IList.Add(Object) IList.Add(Object) IList.Add(Object) IList.Add(Object)

For a description of this member, see Add(Object).

(Inherited from Control.ControlCollection)
IList.Contains(Object) IList.Contains(Object) IList.Contains(Object) IList.Contains(Object)

For a description of this member, see Contains(Object).

(Inherited from Control.ControlCollection)
IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object)

For a description of this member, see IndexOf(Object).

(Inherited from Control.ControlCollection)
IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object)

For a description of this member, see Insert(Int32, Object).

(Inherited from Control.ControlCollection)
IList.Remove(Object) IList.Remove(Object) IList.Remove(Object) IList.Remove(Object)

For a description of this member, see Remove(Object).

(Inherited from Control.ControlCollection)

Extension Methods

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Converts an IEnumerable to an IQueryable.

Applies to

See also