Control.Controls Tulajdonság

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

Control.cs

Lekéri a vezérlőn belül található vezérlők gyűjteményét.

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

Tulajdonság értéke

Control.ControlCollection

A Control.ControlCollection vezérlőben található vezérlők gyűjteményét jelöli.

Attribútumok

BrowsableAttribute

Példák

Az alábbi példakód eltávolít egy Control értéket a Control.ControlCollection származtatott osztályból Panel , ha tagja a gyűjteménynek. A példához létre kell hoznia egy Panel, egy Buttonés legalább egy RadioButton vezérlőt egy Form. A RadioButton vezérlő(k) hozzá lesznek adva a Panel vezérlőhöz, és hozzáadják a Panel vezérlőt a Formvezérlőhöz. Ha a gombra kattint, a névvel ellátott removeButton választógomb el lesz távolítva a Control.ControlCollectionprogramból.

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

Megjegyzések

A Control vezérlők gyűjteménye szülőként is működhet. Ha például több vezérlőt ad hozzá egyhez Form, mindegyik vezérlő az űrlap tulajdonságához Control.ControlCollection tartozik Controls , amely az Control osztályból származik.

A tulajdonsághoz rendelt vezérlőket Control.ControlCollection az osztályban elérhető módszerekkel módosíthatjaControls.Control.ControlCollection

Ha több vezérlőt ad hozzá egy szülővezérlőhöz, javasoljuk, hogy a hozzáadni kívánt vezérlők inicializálása előtt hívja meg a SuspendLayout metódust. Miután hozzáadta a vezérlőket a szülő vezérlőelemhez, hívja meg a metódust ResumeLayout . Ez növeli a számos vezérlővel rendelkező alkalmazások teljesítményét.

Controls A tulajdonság használatával iterálhat egy űrlap összes vezérlője között, beleértve a beágyazott vezérlőket is. Ezzel a GetNextControl módszerrel lekérheti az előző vagy a következő gyermek vezérlőelemet a tabulátorsorrendben. ActiveControl A tulajdonság használatával lekérheti vagy beállíthatja a tárolóvezérlő aktív vezérlőelemét.

Lásd még

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