Control.Controls Vlastnost

Definice

Získá kolekci ovládacích prvků obsažených v ovládacím prvku.

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

Hodnota vlastnosti

Control.ControlCollection

Představuje Control.ControlCollection kolekci ovládacích prvků obsažených v ovládacím prvku.

Atributy

Příklady

Následující příklad kódu odebere Control z odvozené třídyPanel, Control.ControlCollection pokud je členem kolekce. Příklad vyžaduje, abyste vytvořili ovládací Panelprvek , aspoň Buttonjeden RadioButton ovládací prvek .Form Ovládací RadioButton prvky jsou přidány do Panel ovládacího prvku a Panel ovládací prvek přidaný do Form. Po kliknutí na tlačítko se přepínač s názvem removeButton odebere z tlačítka Control.ControlCollection.

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

Poznámky

A Control může fungovat jako nadřazený objekt pro kolekci ovládacích prvků. Například při přidání několika ovládacích prvků do Form, každý z ovládacích prvků je členem Control.ControlCollection přiřazené vlastnosti Controls formuláře, která je odvozena z Control třídy.

Ovládací prvky přiřazené Control.ControlCollection vlastnosti Controls můžete manipulovat pomocí metod dostupných ve Control.ControlCollection třídě.

Při přidávání několika ovládacích prvků do nadřazeného ovládacího prvku se doporučuje volat metodu SuspendLayout před inicializací ovládacích prvků, které se mají přidat. Po přidání ovládacích prvků do nadřazeného ovládacího prvku volejte metodu ResumeLayout . Tím se zvýší výkon aplikací s mnoha ovládacími prvky.

Controls Pomocí vlastnosti iterujte všechny ovládací prvky formuláře, včetně vnořených ovládacích prvků. Použijte metodu GetNextControl k načtení předchozího nebo dalšího podřízeného ovládacího prvku v pořadí ovládacích prvků tabulátoru. ActiveControl Vlastnost slouží k získání nebo nastavení aktivního ovládacího prvku kontejneru.

Platí pro

Viz také