Control.ControlCollection Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Rappresenta una raccolta di oggetti Control.

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

Ereditarietà

Object

ArrangedElementCollection

Control.ControlCollection

Derivato

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

Attributi

ListBindableAttribute

Implementazioni

ICollection IEnumerable IList ICloneable

Esempio

Nell'esempio Control.ControlCollection di codice seguente viene rimosso un Control oggetto dalla classe Panel derivata se è un membro della raccolta. L'esempio richiede che sia stato creato un Panelcontrollo , e Buttonalmeno un RadioButton controllo in un Formoggetto . I RadioButton controlli vengono aggiunti al Panel controllo e il Panel controllo aggiunto a Form. Quando si fa clic sul pulsante, il pulsante di opzione denominato radioButton2 viene rimosso dall'oggetto 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

Commenti

I Addmetodi , Removee RemoveAt consentono di aggiungere e rimuovere singoli controlli dalla raccolta. È anche possibile usare i AddRange metodi o Clear per aggiungere o rimuovere tutti i controlli dalla raccolta.

È possibile determinare se un Control membro della raccolta passa il controllo al Contains metodo . Per ottenere il valore dell'indice della posizione di un Control oggetto nella raccolta, passare il controllo al IndexOf metodo . La raccolta può essere copiata in una matrice chiamando il CopyTo metodo .

Costruttori

Control.ControlCollection(Control)

Inizializza una nuova istanza della classe Control.ControlCollection.

Proprietà

Count	Ottiene il numero di elementi nella raccolta. (Ereditato da ArrangedElementCollection)
IsReadOnly	Ottiene un valore che indica se la raccolta è di sola lettura. (Ereditato da ArrangedElementCollection)
Item[Int32]	Indica il controllo Control nella posizione indicizzata specificata dell'insieme.
Item[String]	Indica un oggetto Control dell'insieme con la chiave specificata.
Owner	Ottiene il controllo proprietario dell'oggetto Control.ControlCollection.

Metodi

Add(Control)	Aggiunge il controllo specificato all'insieme dei controlli.
AddRange(Control[])	Aggiunge una matrice di oggetti controllo all'insieme.
Clear()	Rimuove tutti i controlli dall'insieme.
Contains(Control)	Determina se il controllo specificato è un membro dell'insieme.
ContainsKey(String)	Determina se l'oggetto Control.ControlCollection contiene un elemento con la chiave specificata.
CopyTo(Array, Int32)	Consente di copiare l'intero contenuto di questo insieme in una matrice Array compatibile unidimensionale, a partire dall'indice specificato della matrice di destinazione. (Ereditato da ArrangedElementCollection)
Equals(Object)	Determina se due istanze di ArrangedElementCollection sono uguali. (Ereditato da ArrangedElementCollection)
Find(String, Boolean)	Cerca i controlli in base alla relativa proprietà Name e compila una matrice di tutti i controlli corrispondenti.
GetChildIndex(Control)	Recupera l'indice del controllo figlio specificato all'interno dell'insieme dei controlli.
GetChildIndex(Control, Boolean)	Recupera l'indice del controllo figlio specificato all'interno dell'insieme dei controlli e facoltativamente genera un'eccezione se il controllo specificato non è nell'insieme.
GetEnumerator()	Recupera un riferimento a un oggetto enumeratore usato per eseguire l'iterazione di un oggetto Control.ControlCollection.
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da ArrangedElementCollection)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IndexOf(Control)	Recupera l'indice del controllo specificato all'interno dell'insieme dei controlli.
IndexOfKey(String)	Recupera l'indice della prima occorrenza dell'elemento specificato all'interno dell'insieme.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Remove(Control)	Rimuove il controllo specificato dall'insieme dei controlli.
RemoveAt(Int32)	Rimuove un controllo dall'insieme dei controlli nella posizione di indice specificata.
RemoveByKey(String)	Rimuove il controllo figlio con la chiave specificata.
SetChildIndex(Control, Int32)	Imposta l'indice del controllo figlio specificato nell'insieme sul valore di indice specificato.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

ICloneable.Clone()	Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice. Per una descrizione di questo membro, vedere Clone().
ICollection.IsSynchronized	Per una descrizione di questo membro, vedere la proprietà IsSynchronized. (Ereditato da ArrangedElementCollection)
ICollection.SyncRoot	Per una descrizione di questo membro, vedere la proprietà SyncRoot. (Ereditato da ArrangedElementCollection)
IList.Add(Object)	Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice. Per una descrizione di questo membro, vedere Add(Object).
IList.Clear()	Per una descrizione di questo membro, vedere il metodo Clear(). (Ereditato da ArrangedElementCollection)
IList.Contains(Object)	Per una descrizione di questo membro, vedere il metodo Contains(Object). (Ereditato da ArrangedElementCollection)
IList.IndexOf(Object)	Per una descrizione di questo membro, vedere il metodo IndexOf(Object). (Ereditato da ArrangedElementCollection)
IList.Insert(Int32, Object)	Per una descrizione di questo membro, vedere il metodo Insert(Int32, Object). (Ereditato da ArrangedElementCollection)
IList.IsFixedSize	Per una descrizione di questo membro, vedere la proprietà IsFixedSize. (Ereditato da ArrangedElementCollection)
IList.Item[Int32]	Per una descrizione di questo membro, vedere la proprietà Item[Int32]. (Ereditato da ArrangedElementCollection)
IList.Remove(Object)	Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice. Per una descrizione di questo membro, vedere Remove(Object).
IList.RemoveAt(Int32)	Per una descrizione di questo membro, vedere il metodo RemoveAt(Int32). (Ereditato da ArrangedElementCollection)

Metodi di estensione

Vedi anche

• Control
• IList