Form.ControlCollection-Klasse
Stellt eine Auflistung von Steuerelementen im Formular dar.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)
Syntax
'Declaration
<ComVisibleAttribute(False)> _
Public Class ControlCollection
Inherits ControlCollection
'Usage
Dim instance As ControlCollection
[ComVisibleAttribute(false)]
public class ControlCollection : ControlCollection
[ComVisibleAttribute(false)]
public ref class ControlCollection : public ControlCollection
/** @attribute ComVisibleAttribute(false) */
public class ControlCollection extends ControlCollection
ComVisibleAttribute(false)
public class ControlCollection extends ControlCollection
Hinweise
Diese Klasse stellt die Auflistung von Steuerelementen dar, die in einem Formular enthalten sind. Verwenden Sie die Add-Methode, um dem Formular ein Steuerelement hinzuzufügen, und die Remove-Methode, um das Steuerelement aus dem Formular zu entfernen. Die Steuerelementauflistung, die durch diese Klasse dargestellt wird, kann nicht ohne Bindung an ein bestimmtes Formular erstellt werden. Daher können Sie nicht mehrere Instanzen dieser Steuerelementauflistung erstellen und diese für ein aktives Formular austauschen, um unterschiedliche Steuerelementlayouts bereitzustellen.
Beispiel
Im folgenden Codebeispiel wird der Steuerelementauflistung eines Formulars ein TextBox-Steuerelement und ein Label-Steuerelement hinzugefügt. Im Beispiel ist es erforderlich, dass ein Formular mit dem Namen Form1
erstellt wurde.
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
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:
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 );
}
Vererbungshierarchie
System.Object
System.Windows.Forms.Layout.ArrangedElementCollection
System.Windows.Forms.Control.ControlCollection
System.Windows.Forms.Form.ControlCollection
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
Form.ControlCollection-Member
System.Windows.Forms-Namespace
Control.ControlCollection-Klasse