Control.Controls Eigenschap

Definitie

Hiermee haalt u de verzameling besturingselementen in het besturingselement op.

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

Waarde van eigenschap

Een Control.ControlCollection weergave van de verzameling besturingselementen in het besturingselement.

Kenmerken

Voorbeelden

In het volgende codevoorbeeld wordt een Control van de Control.ControlCollection afgeleide klasse Panel verwijderd als deze lid is van de verzameling. Voor het voorbeeld moet u een Panel, een Buttonen ten minste één RadioButton besturingselement op een Formhebben gemaakt. De RadioButton besturingselementen worden toegevoegd aan het Panel besturingselement en het Panel besturingselement toegevoegd aan het Formbesturingselement. Wanneer op de knop wordt geklikt, wordt het keuzerondje met de naam removeButton verwijderd uit de Control.ControlCollectionknop .

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

Opmerkingen

Een Control kan fungeren als een bovenliggende aan een verzameling besturingselementen. Wanneer bijvoorbeeld meerdere besturingselementen worden toegevoegd aan een Form, is elk van de besturingselementen lid van de Control.ControlCollection eigenschap die is toegewezen aan de Controls eigenschap van het formulier, dat is afgeleid van de Control klasse.

U kunt de besturingselementen in de Control.ControlCollection toegewezen eigenschap Controls bewerken met behulp van de methoden die beschikbaar zijn in de Control.ControlCollection klasse.

Wanneer u meerdere besturingselementen toevoegt aan een bovenliggend besturingselement, wordt u aangeraden de SuspendLayout methode aan te roepen voordat u de besturingselementen initialiseert die moeten worden toegevoegd. Nadat u de besturingselementen aan het bovenliggende besturingselement hebt toegevoegd, roept u de ResumeLayout methode aan. Hierdoor worden de prestaties van toepassingen met veel besturingselementen verbeterd.

Gebruik de Controls eigenschap om alle besturingselementen van een formulier te doorlopen, inclusief geneste besturingselementen. Gebruik de GetNextControl methode om het vorige of volgende onderliggende besturingselement op te halen in de tabvolgorde. Gebruik de ActiveControl eigenschap om het actieve besturingselement van een containerbesturingselement op te halen of in te stellen.

Van toepassing op

Zie ook