Control.ControlCollection Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Stellt eine Auflistung von Control-Objekten dar.

public: ref 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
    inherit ArrangedElementCollection
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

Public Class Control.ControlCollection
Inherits ArrangedElementCollection
Implements ICloneable, IList

Vererbung

Object

ArrangedElementCollection

Control.ControlCollection

Abgeleitet

System.Windows.Forms.DataGridView.DataGridViewControlCollection

System.Windows.Forms.Form.ControlCollection

System.Windows.Forms.MdiClient.ControlCollection

System.Windows.Forms.TabControl.ControlCollection

System.Windows.Forms.TableLayoutControlCollection

System.Windows.Forms.TabPage.TabPageControlCollection

Attribute

ListBindableAttribute

Implementiert

ICollection IEnumerable IList ICloneable

Beispiele

Im folgenden Codebeispiel wird ein Control aus der Control.ControlCollection abgeleiteten Klasse Panel entfernt, wenn es sich um ein Element der Auflistung handelt. Das Beispiel erfordert, dass Sie ein Panel- , ein Button- und mindestens ein RadioButton -Steuerelement für ein Formerstellt haben. Die RadioButton Steuerelemente werden dem Panel -Steuerelement hinzugefügt, und das Panel -Steuerelement wird dem Formhinzugefügt. Wenn auf die Schaltfläche geklickt wird, wird das Optionsfeld mit dem Namen radioButton2 aus Control.ControlCollectionentfernt.

   // 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

Hinweise

Mit den AddMethoden , Remove, und RemoveAt können Sie einzelne Steuerelemente hinzufügen und aus der Auflistung entfernen. Sie können auch die AddRange Methoden oder Clear verwenden, um alle Steuerelemente der Auflistung hinzuzufügen oder daraus zu entfernen.

Sie können ermitteln, ob ein Control Member der Auflistung ist, indem Sie das Steuerelement an die Contains -Methode übergeben. Um den Indexwert des Speicherorts eines Control in der Auflistung abzurufen, übergeben Sie das Steuerelement an die IndexOf -Methode. Die Auflistung kann durch Aufrufen der CopyTo -Methode in ein Array kopiert werden.

Konstruktoren

Control.ControlCollection(Control)

Initialisiert eine neue Instanz der Control.ControlCollection-Klasse.

Eigenschaften

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

Methoden

Add(Control)	Fügt der Steuerelementauflistung das angegebene Steuerelement hinzu.
AddRange(Control[])	Fügt der Auflistung ein Array von Steuerelementobjekten hinzu.
Clear()	Entfernt alle Steuerelemente aus der Auflistung.
Contains(Control)	Bestimmt, ob das angegebene Steuerelement ein Member der Auflistung ist.
ContainsKey(String)	Ermittelt, ob die Control.ControlCollection ein Element mit dem angegebenen Schlüssel enthält.
CopyTo(Array, Int32)	Kopiert den gesamten Inhalt dieser Auflistung in ein kompatibles eindimensionales Array, wobei am angegebenen Index des Zielarrays begonnen wird. (Geerbt von ArrangedElementCollection)
Equals(Object)	Stellt fest, ob zwei ArrangedElementCollection-Instanzen gleich sind. (Geerbt von ArrangedElementCollection)
Find(String, Boolean)	Sucht nach Steuerelementen anhand ihrer Name-Eigenschaft und erstellt ein Array aller übereinstimmenden Steuerelemente.
GetChildIndex(Control)	Ruft den Index des angegebenen untergeordneten Steuerelements in der Steuerelementauflistung ab.
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.
GetEnumerator()	Ruft einen Verweis auf ein Enumeratorobjekt ab, das zum Durchlaufen einer Control.ControlCollection verwendet wird.
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von ArrangedElementCollection)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IndexOf(Control)	Ruft den Index des angegebenen Steuerelements in der Steuerelementauflistung ab.
IndexOfKey(String)	Ruft den Index des ersten Vorkommens des angegebenen Elements innerhalb der Auflistung ab.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Remove(Control)	Entfernt das angegebene Steuerelement aus der Steuerelementauflistung.
RemoveAt(Int32)	Entfernt ein Steuerelement an der angegebenen indizierten Position aus der Steuerelementauflistung.
RemoveByKey(String)	Entfernt das untergeordnete Steuerelement mit dem angegebenen Schlüssel.
SetChildIndex(Control, Int32)	Legt den Index des angegebenen untergeordneten Steuerelements in der Auflistung auf den angegebenen Indexwert fest.
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().
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).
IList.Clear()	Eine Beschreibung dieses Members finden Sie unter der Clear()-Methode. (Geerbt von ArrangedElementCollection)
IList.Contains(Object)	Eine Beschreibung dieses Members finden Sie unter der Contains(Object)-Methode. (Geerbt von ArrangedElementCollection)
IList.IndexOf(Object)	Eine Beschreibung dieses Members finden Sie unter der IndexOf(Object)-Methode. (Geerbt von ArrangedElementCollection)
IList.Insert(Int32, Object)	Eine Beschreibung dieses Members finden Sie unter der Insert(Int32, Object)-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).
IList.RemoveAt(Int32)	Eine Beschreibung dieses Members finden Sie unter der RemoveAt(Int32)-Methode. (Geerbt von ArrangedElementCollection)

Erweiterungsmethoden

Weitere Informationen

• Control
• IList