Control.ControlCollection Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta una raccolta di Control oggetti .
public: ref class Control::ControlCollection : ICloneable, System::Collections::IListpublic: ref class Control::ControlCollection : System::Windows::Forms::Layout::ArrangedElementCollection, ICloneable, System::Collections::IList[System.ComponentModel.ListBindable(false)]
public class Control.ControlCollection : ICloneable, System.Collections.IList[System.ComponentModel.ListBindable(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public class Control.ControlCollection : System.Windows.Forms.Layout.ArrangedElementCollection, ICloneable, System.Collections.IList[<System.ComponentModel.ListBindable(false)>]
type Control.ControlCollection = class
interface IList
interface ICollection
interface IEnumerable
interface ICloneable[<System.ComponentModel.ListBindable(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
type Control.ControlCollection = class
inherit ArrangedElementCollection
interface IList
interface ICollection
interface IEnumerable
interface ICloneablePublic Class Control.ControlCollection
Implements ICloneable, IListPublic Class Control.ControlCollection
Inherits ArrangedElementCollection
Implements ICloneable, IList- Ereditarietà
-
Control.ControlCollection
- Ereditarietà
- Derivato
- Attributi
- Implementazioni
Esempio
Nell'esempio di codice seguente viene rimosso un Control oggetto dalla Control.ControlCollection classe derivata Panel se è un membro della raccolta. L'esempio richiede che sia stato creato un Panelcontrollo , un Buttone almeno un RadioButton controllo in un oggetto Form. 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 da 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 utilizzare i AddRange metodi o Clear per aggiungere o rimuovere tutti i controlli dalla raccolta.
È possibile determinare se un Control oggetto è un membro della raccolta passando il controllo al Contains metodo . Per ottenere il valore di 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
| Nome | Descrizione |
|---|---|
| Control.ControlCollection(Control) |
Inizializza una nuova istanza della classe Control.ControlCollection. |
Proprietà
| Nome | Descrizione |
|---|---|
| Count |
Ottiene il numero di elementi contenuti nell'insieme. |
| Count |
Ottiene il numero di elementi nella raccolta. (Ereditato da ArrangedElementCollection) |
| IsReadOnly |
Ottiene un valore che indica se l'oggetto raccolta è di sola lettura. |
| IsReadOnly |
Ottiene un valore che indica se l'insieme è di sola lettura. (Ereditato da ArrangedElementCollection) |
| Item[Int32] |
Indica l'oggetto Control in corrispondenza della posizione indicizzata specificata nell'insieme. |
| Item[String] |
Indica un Control oggetto con la chiave specificata nella raccolta. |
| Owner |
Ottiene il controllo proprietario di questo Control.ControlCollectionoggetto . |
Metodi
| Nome | Descrizione |
|---|---|
| Add(Control) |
Aggiunge il controllo specificato alla raccolta di controlli. |
| AddRange(Control[]) |
Aggiunge una matrice di oggetti di controllo all'insieme. |
| Clear() |
Rimuove tutti i controlli dalla raccolta. |
| Contains(Control) |
Determina se il controllo specificato è un membro dell'insieme. |
| ContainsKey(String) |
Determina se contiene Control.ControlCollection un elemento con la chiave specificata. |
| CopyTo(Array, Int32) |
Copia gli elementi della raccolta in una matrice, a partire da un indice di matrice specifico. |
| CopyTo(Array, Int32) |
Copia l'intero contenuto di questa raccolta in un oggetto unidimensionale Arraycompatibile, a partire dall'indice specificato della matrice di destinazione. (Ereditato da ArrangedElementCollection) |
| Equals(Object) |
Specifica se l'oggetto insieme corrente e l'oggetto specificato sono uguali. |
| Equals(Object) |
Determina se due ArrangedElementCollection istanze sono uguali. (Ereditato da ArrangedElementCollection) |
| Find(String, Boolean) |
Cerca i controlli in base alla proprietà Name e compila una matrice di tutti i controlli corrispondenti. |
| GetChildIndex(Control, Boolean) |
Recupera l'indice del controllo figlio specificato all'interno dell'insieme di controlli e, facoltativamente, genera un'eccezione se il controllo specificato non si trova all'interno dell'insieme di controlli. |
| GetChildIndex(Control) |
Recupera l'indice del controllo figlio specificato all'interno della raccolta di controlli. |
| GetEnumerator() |
Recupera un riferimento a un oggetto enumeratore utilizzato per scorrere un oggetto Control.ControlCollection. |
| GetHashCode() |
Restituisce il codice hash per questa istanza. |
| GetHashCode() |
Restituisce il codice hash per questa istanza. (Ereditato da ArrangedElementCollection) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| IndexOf(Control) |
Recupera l'indice del controllo specificato nella raccolta di controlli. |
| IndexOfKey(String) |
Recupera l'indice della prima occorrenza dell'elemento specificato all'interno dell'insieme. |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| Remove(Control) |
Rimuove il controllo specificato dalla raccolta di controlli. |
| RemoveAt(Int32) |
Rimuove un controllo dalla raccolta di controlli in corrispondenza della posizione indicizzata 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
| Nome | Descrizione |
|---|---|
| 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 IsSynchronized proprietà . (Ereditato da ArrangedElementCollection) |
| ICollection.SyncRoot |
Per una descrizione di questo membro, vedere la SyncRoot proprietà . (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 Clear() metodo . (Ereditato da ArrangedElementCollection) |
| IList.Contains(Object) |
Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice. Per una descrizione di questo membro, vedere Contains(Object). |
| IList.Contains(Object) |
Per una descrizione di questo membro, vedere il Contains(Object) metodo . (Ereditato da ArrangedElementCollection) |
| IList.IndexOf(Object) |
Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice. Per una descrizione di questo membro, vedere IndexOf(Object). |
| IList.IndexOf(Object) |
Per una descrizione di questo membro, vedere il IndexOf(Object) metodo . (Ereditato da ArrangedElementCollection) |
| IList.Insert(Int32, Object) |
Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice. Per una descrizione di questo membro, vedere Insert(Int32, Object). |
| IList.Insert(Int32, Object) |
Per una descrizione di questo membro, vedere il Insert(Int32, Object) metodo . (Ereditato da ArrangedElementCollection) |
| IList.IsFixedSize |
Per una descrizione di questo membro, vedere la IsFixedSize proprietà . (Ereditato da ArrangedElementCollection) |
| IList.Item[Int32] |
Per una descrizione di questo membro, vedere la Item[Int32] proprietà . (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 RemoveAt(Int32) metodo . (Ereditato da ArrangedElementCollection) |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| AsParallel(IEnumerable) |
Abilita la parallelizzazione di una query. |
| AsQueryable(IEnumerable) |
Converte un IEnumerable in un IQueryable. |
| Cast<TResult>(IEnumerable) |
Esegue il cast degli elementi di un IEnumerable al tipo specificato. |
| OfType<TResult>(IEnumerable) |
Filtra gli elementi di un IEnumerable in base a un tipo specificato. |