Control.ControlCollection Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Představuje kolekci Control objektů.

public: ref class Control::ControlCollection : System::Windows::Forms::Layout::ArrangedElementCollection, ICloneable, System::Collections::IList

[System.ComponentModel.ListBindable(false)]
public class Control.ControlCollection : System.Windows.Forms.Layout.ArrangedElementCollection, ICloneable, System.Collections.IList

[<System.ComponentModel.ListBindable(false)>]
type Control.ControlCollection = class
    inherit ArrangedElementCollection
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

Public Class Control.ControlCollection
Inherits ArrangedElementCollection
Implements ICloneable, IList

Dědičnost

Object

ArrangedElementCollection

Control.ControlCollection

Odvozené

System.Windows.Forms.DataGridView.DataGridViewControlCollection

System.Windows.Forms.Form.ControlCollection

System.Windows.Forms.MdiClient.ControlCollection

System.Windows.Forms.TabControl.ControlCollection

System.Windows.Forms.TableLayoutControlCollection

System.Windows.Forms.TabPage.TabPageControlCollection

Atributy

ListBindableAttribute

Implementuje

ICollection IEnumerable IList ICloneable

Příklady

Následující příklad kódu odebere Control z Control.ControlCollection odvozené třídy Panel , pokud je členem kolekce. Příklad vyžaduje, abyste v objektu PanelButtonvytvořili , a alespoň jeden RadioButton ovládací prvek Form. Ovládací RadioButton prvky se přidají do Panel ovládacího prvku a Panel ovládací prvek se přidá do Form. Po kliknutí na tlačítko se z přepínače odebere Control.ControlCollectionpřepínač s názvem radioButton2 .

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

Metody Add, Removea RemoveAt umožňují přidávat a odebírat jednotlivé ovládací prvky z kolekce. Můžete také použít AddRange metody nebo Clear k přidání nebo odebrání všech ovládacích prvků z kolekce.

Můžete určit, zda Control je členem kolekce předáním ovládacího prvku do Contains metody . Pokud chcete získat hodnotu indexu umístění objektu Control v kolekci, předejte ovládací prvek metodě IndexOf . Kolekci lze zkopírovat do pole voláním CopyTo metody .

Konstruktory

Control.ControlCollection(Control)

Inicializuje novou instanci Control.ControlCollection třídy .

Vlastnosti

Count	Získá počet elementů v kolekci. (Zděděno od ArrangedElementCollection)
IsReadOnly	Získá hodnotu, která udává, zda je kolekce určena jen pro čtení. (Zděděno od ArrangedElementCollection)
Item[Int32]	Označuje v Control zadaném indexovaném umístění v kolekci.
Item[String]	Označuje Control se zadaným klíčem v kolekci.
Owner	Získá ovládací prvek, který vlastní tento Control.ControlCollection.

Metody

Add(Control)	Přidá zadaný ovládací prvek do kolekce ovládacích prvků.
AddRange(Control[])	Přidá pole ovládacích objektů do kolekce.
Clear()	Odebere z kolekce všechny ovládací prvky.
Contains(Control)	Určuje, zda je zadaný ovládací prvek členem kolekce.
ContainsKey(String)	Určuje, zda Control.ControlCollection obsahuje položku se zadaným klíčem.
CopyTo(Array, Int32)	Zkopíruje celý obsah této kolekce do kompatibilního jednorozměrného Arrayobjektu počínaje zadaným indexem cílového pole. (Zděděno od ArrangedElementCollection)
Equals(Object)	Určuje, zda jsou dvě ArrangedElementCollection instance stejné. (Zděděno od ArrangedElementCollection)
Find(String, Boolean)	Vyhledá ovládací prvky podle jejich Name vlastnosti a vytvoří pole všech ovládacích prvků, které odpovídají.
GetChildIndex(Control)	Načte index zadaného podřízeného ovládacího prvku v rámci kolekce ovládacích prvků.
GetChildIndex(Control, Boolean)	Načte index zadaného podřízeného ovládacího prvku v rámci kolekce ovládacích prvků a volitelně vyvolá výjimku, pokud zadaný ovládací prvek není v kolekci ovládacích prvků.
GetEnumerator()	Načte odkaz na objekt enumerátoru, který se používá k iteraci nad objektem Control.ControlCollection.
GetHashCode()	Vrátí hodnotu hash pro tuto instanci. (Zděděno od ArrangedElementCollection)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
IndexOf(Control)	Načte index zadaného ovládacího prvku v kolekci ovládacích prvků.
IndexOfKey(String)	Načte index prvního výskytu zadané položky v kolekci.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
Remove(Control)	Odebere zadaný ovládací prvek z kolekce ovládacích prvků.
RemoveAt(Int32)	Odebere ovládací prvek z kolekce ovládacích prvků v zadaném indexovaném umístění.
RemoveByKey(String)	Odebere podřízený ovládací prvek se zadaným klíčem.
SetChildIndex(Control, Int32)	Nastaví index zadaného podřízeného ovládacího prvku v kolekci na zadanou hodnotu indexu.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

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 najdete v tématu Clone().
ICollection.IsSynchronized	Popis tohoto členu najdete ve IsSynchronized vlastnosti . (Zděděno od ArrangedElementCollection)
ICollection.SyncRoot	Popis tohoto členu najdete 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 najdete v tématu Add(Object).
IList.Clear()	Popis tohoto členu najdete v Clear() metodě . (Zděděno od ArrangedElementCollection)
IList.Contains(Object)	Popis tohoto členu najdete v Contains(Object) metodě . (Zděděno od ArrangedElementCollection)
IList.IndexOf(Object)	Popis tohoto členu najdete v IndexOf(Object) metodě . (Zděděno od ArrangedElementCollection)
IList.Insert(Int32, Object)	Popis tohoto členu najdete v Insert(Int32, Object) metodě . (Zděděno od ArrangedElementCollection)
IList.IsFixedSize	Popis tohoto členu najdete ve IsFixedSize vlastnosti . (Zděděno od ArrangedElementCollection)
IList.Item[Int32]	Popis tohoto členu najdete 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 najdete v tématu Remove(Object).
IList.RemoveAt(Int32)	Popis tohoto členu najdete v RemoveAt(Int32) metodě . (Zděděno od ArrangedElementCollection)

Metody rozšíření

Viz také

• Control
• IList