Homepage Library Lernen Downloads Support Community
Anmelden | United States - English | |
0 von 1 fanden dies hilfreich - Dieses Thema bewerten.

Control.Controls-Eigenschaft

.NET Framework 2.0

Ruft die im Steuerelement enthaltene Auflistung von Steuerelementen ab.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

C#
C++
VB
Kopieren 
public ControlCollection Controls { get; }
J#
Kopieren 
/** @property */
public ControlCollection get_Controls ()
JScript
Kopieren 
public function get Controls () : ControlCollection

Eigenschaftenwert

Eine Control.ControlCollection, die die Auflistung der im Steuerelement enthaltenen Steuerelemente darstellt.

Ein Control kann als übergeordnetes Element einer Auflistung von Steuerelementen fungieren. Wenn z. B. mehrere Steuerelemente einem Form hinzugefügt werden, ist jedes Steuerelement ein Member des Control.ControlCollection-Objekts, das der Controls-Eigenschaft des von der Control-Klasse abgeleiteten Formulars zugewiesen ist.

Sie können die Steuerelemente in der der Controls-Eigenschaft zugewiesenen Control.ControlCollection mithilfe der in der Control.ControlCollection-Klasse bereitgestellten Methoden bearbeiten.

Wenn Sie mehrere Steuerelemente einem übergeordneten Steuerelement hinzufügen, empfiehlt es sich, vor dem Initialisieren der hinzuzufügenden Steuerelemente die SuspendLayout-Methode aufzurufen. Rufen Sie die ResumeLayout-Methode auf, nachdem die Steuerelemente dem übergeordneten Steuerelement hinzugefügt wurden. Dies erhöht bei vielen Steuerelementen die Leistung der Anwendung.

Im folgenden Codebeispiel wird ein Control aus der Control.ControlCollection des Panel der abgeleiteten Klasse entfernt, wenn es ein Member der Auflistung ist. Bei diesem Beispiel muss ein Panel-Steuerelement, ein Button und mindestens ein RadioButton-Steuerelement in einem Form erstellt worden sein. Die RadioButton-Steuerelemente werden dem Panel-Steuerelement hinzugefügt, und das Panel-Steuerelement wird dem Form hinzugefügt. Beim Klicken auf die Schaltfläche wird das Optionsfeld radioButton2 aus der Control.ControlCollection entfernt.

C#
C++
VB
Kopieren 
// 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);
   }
}
J#
Kopieren 
// Remove the RadioButton control if it exists.
private void removeButton_Click(Object sender, System.EventArgs e)
{
    if (panel1.get_Controls().Contains(removeButton)) {
        panel1.get_Controls().Remove(removeButton);
    }
} //removeButton_Click

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.

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)