Form.ControlCollection Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

Form.ControlCollection.cs

Představuje kolekci ovládacích prvků ve formuláři.

public: ref class Form::ControlCollection : System::Windows::Forms::Control::ControlCollection

public class Form.ControlCollection : System.Windows.Forms.Control.ControlCollection

type Form.ControlCollection = class
    inherit Control.ControlCollection

Public Class Form.ControlCollection
Inherits Control.ControlCollection

Dědičnost

Object

ArrangedElementCollection

Control.ControlCollection

Form.ControlCollection

Příklady

Následující příklad kódu přidá TextBox a Label ovládací prvek do kolekce ovládacího prvku formuláře. Příklad vyžaduje vytvoření a pojmenování Form1formuláře .

public:
   void AddMyControls()
   {
      TextBox^ textBox1 = gcnew TextBox;
      Label^ label1 = gcnew Label;
      
      // Initialize the controls and their bounds.
      label1->Text = "First Name";
      label1->Location = Point( 48, 48 );
      label1->Size = System::Drawing::Size( 104, 16 );
      textBox1->Text = "";
      textBox1->Location = Point(48,64);
      textBox1->Size = System::Drawing::Size( 104, 16 );
      
      // Add the TextBox control to the form's control collection.
      Controls->Add( textBox1 );
      // Add the Label control to the form's control collection.
      Controls->Add( label1 );
   }

public void AddMyControls()
 {
    TextBox textBox1 = new TextBox();
    Label label1 = new Label();
    
    // Initialize the controls and their bounds.
    label1.Text = "First Name";
    label1.Location = new Point(48,48);
    label1.Size = new Size (104, 16);
    textBox1.Text = "";
    textBox1.Location = new Point(48, 64);
    textBox1.Size = new Size(104,16);
 
    // Add the TextBox control to the form's control collection.
    Controls.Add(textBox1);
    // Add the Label control to the form's control collection.
    Controls.Add(label1);
 }

Public Sub AddMyControls()
    Dim textBox1 As New TextBox()
    Dim label1 As New Label()
    
    ' Initialize the controls and their bounds.
    label1.Text = "First Name"
    label1.Location = New Point(48, 48)
    label1.Size = New Size(104, 16)
    textBox1.Text = ""
    textBox1.Location = New Point(48, 64)
    textBox1.Size = New Size(104, 16)
    
    ' Add the TextBox control to the form's control collection.
    Controls.Add(textBox1)
    ' Add the Label control to the form's control collection.
    Controls.Add(label1)
End Sub

Poznámky

Tato třída představuje kolekci ovládacích prvků obsažených ve formuláři. Tuto metodu Add můžete použít k přidání ovládacího prvku do formuláře a Remove metody k odebrání ovládacího prvku z formuláře. Kolekci ovládacích prvků reprezentovanou touto třídou nelze vytvořit bez vazby na konkrétní formulář. V důsledku toho nelze vytvořit více instancí této kolekce ovládacích prvků a zaměnit je s aktivním formulářem, aby bylo možné poskytovat různá rozložení ovládacích prvků.

Konstruktory

Name	Description
Form.ControlCollection(Form)	Inicializuje novou instanci Form.ControlCollection třídy.

Vlastnosti

Name	Description
Item[Int32]	Určuje Control v zadaném indexovaném umístění v kolekci. (Zděděno od Control.ControlCollection)
Item[String]	Označuje klíč se zadaným Control klíčem v kolekci. (Zděděno od Control.ControlCollection)
Owner	Získá ovládací prvek, který to Control.ControlCollectionvlastní . (Zděděno od Control.ControlCollection)

Metody

Name	Description
Add(Control)	Přidá do formuláře ovládací prvek.
AddRange(Control[])	Přidá do kolekce pole řídicích objektů. (Zděděno od Control.ControlCollection)
Clear()	Odebere všechny ovládací prvky z kolekce. (Zděděno od Control.ControlCollection)
Contains(Control)	Určuje, zda je zadaný ovládací prvek členem kolekce. (Zděděno od Control.ControlCollection)
ContainsKey(String)	Určuje, zda Control.ControlCollection obsahuje položku se zadaným klíčem. (Zděděno od Control.ControlCollection)
Find(String, Boolean)	Vyhledá ovládací prvky podle jejich Name vlastnosti a vytvoří pole všech odpovídajících ovládacích prvků. (Zděděno od Control.ControlCollection)
GetChildIndex(Control, Boolean)	Načte index zadaného podřízeného ovládacího prvku v kolekci ovládacích prvků a volitelně vyvolá výjimku, pokud zadaný ovládací prvek není v kolekci ovládacích prvků. (Zděděno od Control.ControlCollection)
GetChildIndex(Control)	Načte index zadaného podřízeného ovládacího prvku v rámci kolekce ovládacích prvků. (Zděděno od Control.ControlCollection)
GetEnumerator()	Načte odkaz na objekt enumerátoru, který se používá k iteraci nad objektem Control.ControlCollection. (Zděděno od Control.ControlCollection)
IndexOf(Control)	Načte index zadaného ovládacího prvku v kolekci ovládacích prvků. (Zděděno od Control.ControlCollection)
IndexOfKey(String)	Načte index prvního výskytu zadané položky v kolekci. (Zděděno od Control.ControlCollection)
Remove(Control)	Odebere ovládací prvek z formuláře.
RemoveAt(Int32)	Odebere ovládací prvek z kolekce ovládacích prvků v zadaném indexovaném umístění. (Zděděno od Control.ControlCollection)
RemoveByKey(String)	Odebere podřízený ovládací prvek se zadaným klíčem. (Zděděno od Control.ControlCollection)
SetChildIndex(Control, Int32)	Nastaví index zadaného podřízeného ovládacího prvku v kolekci na zadanou hodnotu indexu. (Zděděno od Control.ControlCollection)

Explicitní implementace rozhraní

Name	Description
ICloneable.Clone()	Toto rozhraní API podporuje produktovou infrastrukturu a není určené k použití přímo z uživatelského kódu. Popis tohoto člena naleznete v tématu Clone(). (Zděděno od Control.ControlCollection)
ICollection.IsSynchronized	Popis tohoto člena naleznete ve IsSynchronized vlastnosti. (Zděděno od ArrangedElementCollection)
ICollection.SyncRoot	Popis tohoto člena naleznete ve SyncRoot vlastnosti. (Zděděno od ArrangedElementCollection)
IList.Add(Object)	Toto rozhraní API podporuje produktovou infrastrukturu a není určené k použití přímo z uživatelského kódu. Popis tohoto člena naleznete v tématu Add(Object). (Zděděno od Control.ControlCollection)
IList.Clear()	Popis tohoto člena najdete v Clear() metodě. (Zděděno od ArrangedElementCollection)
IList.IsFixedSize	Popis tohoto člena naleznete ve IsFixedSize vlastnosti. (Zděděno od ArrangedElementCollection)
IList.Item[Int32]	Popis tohoto člena naleznete ve Item[Int32] vlastnosti. (Zděděno od ArrangedElementCollection)
IList.Remove(Object)	Toto rozhraní API podporuje produktovou infrastrukturu a není určené k použití přímo z uživatelského kódu. Popis tohoto člena naleznete v tématu Remove(Object). (Zděděno od Control.ControlCollection)
IList.RemoveAt(Int32)	Popis tohoto člena najdete v RemoveAt(Int32) metodě. (Zděděno od ArrangedElementCollection)

Viz také

• Control.ControlCollection