Control.Controls Eigenschaft

Definition

Ruft die im Steuerelement enthaltene Auflistung von Steuerelementen ab.

public:
 property System::Windows::Forms::Control::ControlCollection ^ Controls { System::Windows::Forms::Control::ControlCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.Control.ControlCollection Controls { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Controls : System.Windows.Forms.Control.ControlCollection
Public ReadOnly Property Controls As Control.ControlCollection

Eigenschaftswert

Control.ControlCollection

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

Attribute

Beispiele

Im folgenden Codebeispiel wird eine Control aus der Control.ControlCollection abgeleiteten Klasse Panel entfernt, wenn es sich um ein Element der Auflistung handelt. Das Beispiel erfordert, dass Sie ein , ein Panel, ein Buttonund mindestens ein RadioButton Steuerelement auf einem FormSteuerelement erstellt haben. Die RadioButton Steuerelemente werden dem Panel Steuerelement hinzugefügt, und das Panel Steuerelement wird dem FormSteuerelement hinzugefügt. Wenn auf die Schaltfläche geklickt wird, wird das Optionsfeld mit dem Namen removeButton aus der Control.ControlCollectionSchaltfläche entfernt.

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

A Control kann als übergeordnetes Element einer Sammlung von Steuerelementen fungieren. Wenn beispielsweise mehreren Steuerelementen ein FormElement hinzugefügt wird, ist jede der Steuerelemente ein Element Control.ControlCollection Controls der Eigenschaft des Formulars, das von der Control Klasse abgeleitet wird.

Sie können die Steuerelemente in der Control.ControlCollection Controls Eigenschaft mithilfe der methoden bearbeiten, die in der Control.ControlCollection Klasse verfügbar sind.

Wenn Sie einem übergeordneten Steuerelement mehrere Steuerelemente hinzufügen, wird empfohlen, die SuspendLayout Methode vor dem Initialisieren der hinzuzufügenden Steuerelemente aufzurufen. Rufen Sie nach dem Hinzufügen der Steuerelemente zum übergeordneten Steuerelement die ResumeLayout Methode auf. Dadurch wird die Leistung von Anwendungen mit vielen Steuerelementen erhöht.

Verwenden Sie die Controls Eigenschaft, um alle Steuerelemente eines Formulars zu durchlaufen, einschließlich geschachtelter Steuerelemente. Verwenden Sie die GetNextControl Methode, um das vorherige oder nächste untergeordnete Steuerelement in der Aktivierreihenfolge abzurufen. Verwenden Sie die ActiveControl Eigenschaft, um das aktive Steuerelement eines Containersteuerelements abzurufen oder festzulegen.

Gilt für:

Siehe auch