Control.ControlCollection Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

Control.ControlCollection.cs

Objektumok gyűjteményét Control jelöli.

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

Öröklődés

Object

ArrangedElementCollection

Control.ControlCollection

Származtatott

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

Attribútumok

ListBindableAttribute

Megvalósítás

ICollection IEnumerable IList ICloneable

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áadódnak a Panel vezérlőhöz.Form Ha a gombra kattint, a névvel ellátott radioButton2 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 Add, Removeés RemoveAt a metódusok lehetővé teszik egyéni vezérlők hozzáadását és eltávolítását a gyűjteményből. A gyűjtemény összes vezérlőjének AddRange hozzáadására vagy Clear eltávolítására is használhatja a metódusokat.

A vezérlőelem metódusba Control való átadásával megállapíthatja, hogy egy gyűjtemény tagja-eContains. Egy gyűjtemény helyének indexértékének Control lekéréséhez adja át a vezérlőt a IndexOf metódusnak. A gyűjtemény a metódus meghívásával CopyTo másolható egy tömbbe.

Konstruktorok

Name	Description
Control.ControlCollection(Control)	Inicializálja a Control.ControlCollection osztály új példányát.

Tulajdonságok

Name	Description
Count	Lekéri a gyűjtemény elemeinek számát. (Öröklődés forrása ArrangedElementCollection)
IsReadOnly	Beolvas egy értéket, amely jelzi, hogy a gyűjtemény írásvédett-e. (Öröklődés forrása ArrangedElementCollection)
Item[Int32]	Control A gyűjtemény megadott indexelt helyén jelzi a értéket.
Item[String]	Control A gyűjteményben megadott kulccsal rendelkező értéket jelez.
Owner	Lekéri a vezérlőt, amely ezt Control.ControlCollectionbirtokolja.

Metódusok

Name	Description
Add(Control)	Hozzáadja a megadott vezérlőt a vezérlőgyűjteményhez.
AddRange(Control[])	Vezérlőobjektum-tömböt ad hozzá a gyűjteményhez.
Clear()	Eltávolítja az összes vezérlőt a gyűjteményből.
Contains(Control)	Meghatározza, hogy a megadott vezérlő tagja-e a gyűjteménynek.
ContainsKey(String)	Meghatározza, hogy a Control.ControlCollection megadott kulccsal rendelkező elemet tartalmaz-e.
CopyTo(Array, Int32)	A gyűjtemény teljes tartalmát egy kompatibilis egydimenziósra Arraymásolja a céltömb megadott indexétől kezdve. (Öröklődés forrása ArrangedElementCollection)
Equals(Object)	Meghatározza, hogy két ArrangedElementCollection példány egyenlő-e. (Öröklődés forrása ArrangedElementCollection)
Find(String, Boolean)	Megkeresi a vezérlőket a tulajdonságuk Name alapján, és létrehoz egy tömböt az összes egyező vezérlőből.
GetChildIndex(Control, Boolean)	Lekéri a megadott gyermekvezérlő indexét a vezérlőgyűjteményen belül, és opcionálisan kivételt jelez, ha a megadott vezérlő nem szerepel a vezérlőgyűjteményben.
GetChildIndex(Control)	Lekéri a megadott gyermekvezérlő indexét a vezérlőgyűjteményben.
GetEnumerator()	Egy enumerátorobjektumra mutató hivatkozást kér le, amely Control.ControlCollectionegy .
GetHashCode()	A példány kivonatkódját adja vissza. (Öröklődés forrása ArrangedElementCollection)
IndexOf(Control)	Lekéri a vezérlőgyűjteményben megadott vezérlőelem indexét.
IndexOfKey(String)	Lekéri a megadott elem első előfordulásának indexét a gyűjteményen belül.
Remove(Control)	Eltávolítja a megadott vezérlőt a vezérlőgyűjteményből.
RemoveAt(Int32)	Eltávolít egy vezérlőt a vezérlőelem-gyűjteményből a megadott indexelt helyen.
RemoveByKey(String)	Eltávolítja a gyermekvezérlőt a megadott kulccsal.
SetChildIndex(Control, Int32)	A gyűjtemény megadott gyermekvezérlőjének indexét a megadott indexértékre állítja.

Explicit interfész-implementációk

Name	Description
ICloneable.Clone()	Ez az API a termékinfrastruktúrát támogatja, és közvetlenül a kódból nem használható. Ennek a tagnak a leírását lásd Clone(): .
ICollection.IsSynchronized	A tag leírását a tulajdonságban IsSynchronized talál. (Öröklődés forrása ArrangedElementCollection)
ICollection.SyncRoot	A tag leírását a tulajdonságban SyncRoot talál. (Öröklődés forrása ArrangedElementCollection)
IList.Add(Object)	Ez az API a termékinfrastruktúrát támogatja, és közvetlenül a kódból nem használható. Ennek a tagnak a leírását lásd Add(Object): .
IList.Clear()	Ennek a tagnak a leírását a Clear() metódus ismerteti. (Öröklődés forrása ArrangedElementCollection)
IList.Contains(Object)	Ennek a tagnak a leírását a Contains(Object) metódus ismerteti. (Öröklődés forrása ArrangedElementCollection)
IList.IndexOf(Object)	Ennek a tagnak a leírását a IndexOf(Object) metódus ismerteti. (Öröklődés forrása ArrangedElementCollection)
IList.Insert(Int32, Object)	Ennek a tagnak a leírását a Insert(Int32, Object) metódus ismerteti. (Öröklődés forrása ArrangedElementCollection)
IList.IsFixedSize	A tag leírását a tulajdonságban IsFixedSize talál. (Öröklődés forrása ArrangedElementCollection)
IList.Item[Int32]	A tag leírását a tulajdonságban Item[Int32] talál. (Öröklődés forrása ArrangedElementCollection)
IList.Remove(Object)	Ez az API a termékinfrastruktúrát támogatja, és közvetlenül a kódból nem használható. Ennek a tagnak a leírását lásd Remove(Object): .
IList.RemoveAt(Int32)	Ennek a tagnak a leírását a RemoveAt(Int32) metódus ismerteti. (Öröklődés forrása ArrangedElementCollection)

Lásd még

• Control
• IList