Control.Controls Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.ControlCollectionPublic ReadOnly Property Controls As Control.ControlCollectionEigenschaftswert
Eine Control.ControlCollection, die die Auflistung der im Steuerelement enthaltenen Steuerelemente darstellt.
- Attribute
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.
