Control.ControlCollection Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

Control.ControlCollection.cs

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. Tento příklad vyžaduje, abyste vytvořili Panelovládací prvek , 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řidán do .Form Po kliknutí na tlačítko je přepínač s názvem radioButton2 odebrán z Control.ControlCollectiontlačítka .

   // 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 AddRemoveRemoveAt metody umožňují přidávat a odebírat jednotlivé ovládací prvky z kolekce. K přidání nebo odebrání všech ovládacích prvků z kolekce můžete použít AddRangeClear také tyto metody.

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

Konstruktory

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

Vlastnosti

Name	Description
Count	Získá počet prvků v kolekci. (Zděděno od ArrangedElementCollection)
IsReadOnly	Získá hodnotu určující, zda kolekce je jen pro čtení. (Zděděno od ArrangedElementCollection)
Item[Int32]	Určuje Control v zadaném indexovaném umístění v kolekci.
Item[String]	Označuje klíč se zadaným Control klíčem v kolekci.
Owner	Získá ovládací prvek, který to Control.ControlCollectionvlastní .

Metody

Name	Description
Add(Control)	Přidá zadaný ovládací prvek do kolekce ovládacích prvků.
AddRange(Control[])	Přidá do kolekce pole řídicích objektů.
Clear()	Odebere všechny ovládací prvky z kolekce.
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 Array, 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 odpovídajících ovládacích prvků.
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ů.
GetChildIndex(Control)	Načte index zadaného podřízeného ovládacího prvku v rámci kolekce 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í kód hash pro tuto instanci. (Zděděno od ArrangedElementCollection)
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.
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.

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().
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).
IList.Clear()	Popis tohoto člena najdete v Clear() metodě. (Zděděno od ArrangedElementCollection)
IList.Contains(Object)	Popis tohoto člena najdete v Contains(Object) metodě. (Zděděno od ArrangedElementCollection)
IList.IndexOf(Object)	Popis tohoto člena najdete v IndexOf(Object) metodě. (Zděděno od ArrangedElementCollection)
IList.Insert(Int32, Object)	Popis tohoto člena najdete v Insert(Int32, Object) 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).
IList.RemoveAt(Int32)	Popis tohoto člena najdete v RemoveAt(Int32) metodě. (Zděděno od ArrangedElementCollection)

Viz také

• Control
• IList