Form.ControlCollection Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Stellt eine Auflistung von Steuerelemente auf dem Formular dar.

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

Vererbung

Object

ArrangedElementCollection

Control.ControlCollection

Form.ControlCollection

Beispiele

Im folgenden Codebeispiel werden der Steuerelementauflistung eines Formulars ein TextBox - und Label -Steuerelement hinzugefügt. Das Beispiel erfordert, dass ein Formular mit dem Namen Form1erstellt wurde.

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

Hinweise

Diese Klasse stellt die Auflistung von Steuerelementen dar, die in einem Formular enthalten sind. Sie können die Add -Methode verwenden, um dem Formular ein Steuerelement hinzuzufügen, und die Remove -Methode, um das Steuerelement aus dem Formular zu entfernen. Die von dieser Klasse dargestellte Steuerelementauflistung kann nicht erstellt werden, ohne sie an ein bestimmtes Formular zu binden. Daher können Sie nicht mehrere Instanzen dieser Steuerelementsammlung erstellen und sie mit einem aktiven Formular ersetzen, um unterschiedliche Steuerelementlayouts bereitzustellen.

Konstruktoren

Form.ControlCollection(Form)

Initialisiert eine neue Instanz der Form.ControlCollection-Klasse.

Eigenschaften

Count	Ruft die Anzahl der Elemente in der Auflistung ab. (Geerbt von Control.ControlCollection)
IsReadOnly	Ruft einen Wert ab, der angibt, ob dieses Auflistungsobjekt schreibgeschützt ist. (Geerbt von Control.ControlCollection)
Item[Int32]	Gibt das Control an der angegebenen indizierten Position in der Auflistung an. (Geerbt von Control.ControlCollection)
Item[String]	Gibt ein Control mit dem angegebenen Schlüssel in der Auflistung an. (Geerbt von Control.ControlCollection)
Owner	Ruft das Steuerelement ab, das diese Control.ControlCollection besitzt. (Geerbt von Control.ControlCollection)

Methoden

Add(Control)	Fügt dem Formular ein Steuerelement hinzu.
AddRange(Control[])	Fügt der Auflistung ein Array von Steuerelementobjekten hinzu. (Geerbt von Control.ControlCollection)
Clear()	Entfernt alle Steuerelemente aus der Auflistung. (Geerbt von Control.ControlCollection)
Contains(Control)	Bestimmt, ob das angegebene Steuerelement ein Member der Auflistung ist. (Geerbt von Control.ControlCollection)
ContainsKey(String)	Ermittelt, ob die Control.ControlCollection ein Element mit dem angegebenen Schlüssel enthält. (Geerbt von Control.ControlCollection)
CopyTo(Array, Int32)	Kopiert die Elemente der Auflistung in ein Array, wobei an einem bestimmten Arrayindex begonnen wird. (Geerbt von Control.ControlCollection)
Equals(Object)	Gibt an, ob das aktuelle Auflistungsobjekt und das angegebene Objekt gleich sind. (Geerbt von Control.ControlCollection)
Find(String, Boolean)	Sucht nach Steuerelementen anhand ihrer Name-Eigenschaft und erstellt ein Array aller übereinstimmenden Steuerelemente. (Geerbt von Control.ControlCollection)
GetChildIndex(Control)	Ruft den Index des angegebenen untergeordneten Steuerelements in der Steuerelementauflistung ab. (Geerbt von Control.ControlCollection)
GetChildIndex(Control, Boolean)	Ruft den Index des angegebenen untergeordneten Steuerelements in der Steuerelementauflistung ab und löst optional eine Ausnahme aus, wenn das angegebene Steuerelement nicht in der Steuerelementauflistung enthalten ist. (Geerbt von Control.ControlCollection)
GetEnumerator()	Ruft einen Verweis auf ein Enumeratorobjekt ab, das zum Durchlaufen einer Control.ControlCollection verwendet wird. (Geerbt von Control.ControlCollection)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Control.ControlCollection)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IndexOf(Control)	Ruft den Index des angegebenen Steuerelements in der Steuerelementauflistung ab. (Geerbt von Control.ControlCollection)
IndexOfKey(String)	Ruft den Index des ersten Vorkommens des angegebenen Elements innerhalb der Auflistung ab. (Geerbt von Control.ControlCollection)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Remove(Control)	Entfernt ein Steuerelement aus dem Formular.
RemoveAt(Int32)	Entfernt ein Steuerelement an der angegebenen indizierten Position aus der Steuerelementauflistung. (Geerbt von Control.ControlCollection)
RemoveByKey(String)	Entfernt das untergeordnete Steuerelement mit dem angegebenen Schlüssel. (Geerbt von Control.ControlCollection)
SetChildIndex(Control, Int32)	Legt den Index des angegebenen untergeordneten Steuerelements in der Auflistung auf den angegebenen Indexwert fest. (Geerbt von Control.ControlCollection)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

ICloneable.Clone()	Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht. Eine Beschreibung dieses Elements finden Sie unter Clone(). (Geerbt von Control.ControlCollection)
ICollection.IsSynchronized	Eine Beschreibung dieses Members finden Sie unter der IsSynchronized-Eigenschaft. (Geerbt von ArrangedElementCollection)
ICollection.SyncRoot	Eine Beschreibung dieses Members finden Sie unter der SyncRoot-Eigenschaft. (Geerbt von ArrangedElementCollection)
IList.Add(Object)	Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht. Eine Beschreibung dieses Elements finden Sie unter Add(Object). (Geerbt von Control.ControlCollection)
IList.Clear()	Eine Beschreibung dieses Members finden Sie unter der Clear()-Methode. (Geerbt von ArrangedElementCollection)
IList.IsFixedSize	Eine Beschreibung dieses Members finden Sie unter der IsFixedSize-Eigenschaft. (Geerbt von ArrangedElementCollection)
IList.Item[Int32]	Eine Beschreibung dieses Members finden Sie unter der Item[Int32]-Eigenschaft. (Geerbt von ArrangedElementCollection)
IList.Remove(Object)	Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht. Eine Beschreibung dieses Elements finden Sie unter Remove(Object). (Geerbt von Control.ControlCollection)
IList.RemoveAt(Int32)	Eine Beschreibung dieses Members finden Sie unter der RemoveAt(Int32)-Methode. (Geerbt von ArrangedElementCollection)

Erweiterungsmethoden

Weitere Informationen

• Control.ControlCollection