Control.Controls-Eigenschaft

Artikel
08/20/2007

Ruft die im Steuerelement enthaltene Auflistung von Steuerelementen ab.

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

Syntax

'Declaration
Public ReadOnly Property Controls As ControlCollection
'Usage
Dim instance As Control
Dim value As ControlCollection

value = instance.Controls

public ControlCollection Controls { get; }

public:
property ControlCollection^ Controls {
    ControlCollection^ get ();
}

/** @property */
public ControlCollection get_Controls ()

public function get Controls () : ControlCollection

Eigenschaftenwert

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

Hinweise

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.

Beispiel

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.

' 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(RadioAddRangeButton) Then
        Panel1.Controls.Remove(RadioAddRangeButton)
    End If
End Sub

// 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 void removeButton_Click(Object sender, System.EventArgs e)
{
    if (panel1.get_Controls().Contains(removeButton)) {
        panel1.get_Controls().Remove(removeButton);
    }
} //removeButton_Click

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

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
Control.ControlCollection
CreateControlsInstance
SuspendLayout
ResumeLayout

Freigeben über