Control.Controls Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

BrowsableAttribute

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

Ein Control kann als übergeordnetes Element für eine Auflistung von Steuerelementen fungieren. Wenn z. B. mehrere Steuerelemente zu einem Formhinzugefügt werden, ist jedes der Steuerelemente ein Member der Control.ControlCollection - Controls Eigenschaft des Formulars, das von der Control -Klasse abgeleitet wird.

Sie können die Steuerelemente in der Control.ControlCollection - Controls Eigenschaft bearbeiten, indem Sie die in der Control.ControlCollection -Klasse verfügbaren Methoden verwenden.

Beim Hinzufügen mehrerer Steuerelemente zu einem übergeordneten Steuerelement empfiehlt es sich, die SuspendLayout -Methode aufzurufen, bevor Sie die hinzuzufügenden Steuerelemente initialisieren. Nachdem Sie die Steuerelemente zum übergeordneten Steuerelement hinzugefügt haben, rufen Sie die -Methode auf ResumeLayout . 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 Registerkartenreihenfolge abzurufen. Verwenden Sie die ActiveControl -Eigenschaft, um das aktive Steuerelement eines Containersteuerelements abzurufen oder festzulegen.

Weitere Informationen

• Control.ControlCollection
• CreateControlsInstance()
• SuspendLayout()
• ResumeLayout()