Form.ControlCollection 类

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

表示窗体控件的集合。

public: ref class Form::ControlCollection : System::Windows::Forms::Control::ControlCollection

public class Form.ControlCollection : System.Windows.Forms.Control.ControlCollection

type Form.ControlCollection = class
    inherit Control.ControlCollection

Public Class Form.ControlCollection
Inherits Control.ControlCollection

继承

Object

ArrangedElementCollection

Control.ControlCollection

Form.ControlCollection

示例

下面的代码示例将 和 Label 控件添加到TextBox窗体的控件集合中。 该示例要求已创建一个名为 的 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

注解

此类表示窗体中包含的控件的集合。 可以使用 方法向窗体添加控件，并使用 AddRemove 方法从窗体中删除控件。 如果不将此类绑定到特定窗体，则无法创建此类表示的控件集合。 因此，无法创建此控件集合的多个实例，并将它们与活动窗体交换以提供不同的控件布局。

构造函数

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)	检索控件集合内的指定子控件的索引。 (继承自 Control.ControlCollection)
GetChildIndex(Control, Boolean)	检索控件集合内的指定子控件的索引，并且如果指定控件不在控件集合内，也可能引发异常。 (继承自 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.IsFixedSize	有关此成员的说明，请参见 IsFixedSize 属性。 (继承自 ArrangedElementCollection)
IList.Item[Int32]	有关此成员的说明，请参见 Item[Int32] 属性。 (继承自 ArrangedElementCollection)
IList.Remove(Object)	此 API 支持产品基础结构，不能在代码中直接使用。 有关此成员的说明，请参见 Remove(Object)。 (继承自 Control.ControlCollection)
IList.RemoveAt(Int32)	有关此成员的说明，请参见 RemoveAt(Int32) 方法。 (继承自 ArrangedElementCollection)

扩展方法

另请参阅

• Control.ControlCollection