Interfaccia ControlCollection

Articolo
08/11/2011

Rappresenta un insieme di controlli gestiti in un foglio di lavoro di Excel in una soluzione Office.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
<GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")> _
Public Interface ControlCollection _
    Inherits IEnumerable

[GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")]
public interface ControlCollection : IEnumerable

Il tipo ControlCollection espone i seguenti membri.

Proprietà

	Nome	Descrizione
	Count	Ottiene il numero di controlli inclusi in ControlCollection.
	Item[Int32]	Ottiene il controllo in corrispondenza dell'indice specificato.
	Item[String]	Ottiene il controllo con il nome specificato.

In alto

Metodi

	Nome	Descrizione
	AddChart(Range, String)	Aggiunge un nuovo controllo Chart al foglio di lavoro in corrispondenza dell'intervallo specificato.
	AddChart(Double, Double, Double, Double, String)	Aggiunge un nuovo controllo Chart al foglio di lavoro con le dimensioni e la posizione specificate.
	AddControl(Control, Range, String)	Aggiunge l'oggetto Control specificato all'oggetto ControlCollection nell'intervallo specificato.
	AddControl(Control, Double, Double, Double, Double, String)	Aggiunge l'oggetto Control specificato all'oggetto ControlCollection con le dimensioni e la posizione specificate.
	AddListObject(ListObject)	Aggiunge un oggetto Microsoft.Office.Tools.Excel.ListObject di Visual Studio all'insieme di controlli in base all'oggetto nativo Microsoft.Office.Interop.Excel.ListObject specificato.
	AddListObject(Range, String)	Aggiunge un nuovo controllo ListObject al foglio di lavoro in corrispondenza dell'intervallo specificato.
	AddNamedRange	Aggiunge un nuovo controllo NamedRange al foglio di lavoro in corrispondenza dell'intervallo specificato.
	Contains(Object)	Determina se il controllo specificato è un membro dell'istanza di ControlCollection.
	Contains(String)	Determina se un controllo con il nome specificato è un membro dell'istanza di ControlCollection.
	GetEnumerator	Viene restituito un enumeratore che scorre un insieme. (Ereditato da IEnumerable)
	IndexOf(Object)	Esegue la ricerca del controllo specificato e restituisce l'indice in base zero della prima occorrenza nell'istanza di ControlCollection.
	IndexOf(String)	Esegue la ricerca della prima occorrenza di un controllo con il nome specificato nell'istanza di ControlCollection.
	Remove(Object)	Rimuove il controllo specificato dall'istanza di ControlCollection.
	Remove(String)	Rimuove il controllo con il nome specificato dall'istanza di ControlCollection.
	RemoveAt	Rimuove il controllo corrispondente all'indice specificato nell'istanza di ControlCollection.

In alto

Note

Utilizzare i metodi e le proprietà dell'interfaccia ControlCollection per gestire i controlli in un foglio di lavoro di Excel. Per ulteriori informazioni, vedere Aggiunta di controlli ai documenti di Office in fase di esecuzione.

Non è possibile creare un'istanza di questa interfaccia nel codice, perché non dispone di costruttori pubblici. Per ottenere un'istanza di questa interfaccia in un progetto a livello di documento, utilizzare la proprietà Controls di una delle classi n Sheet nel progetto. Per ottenere un'istanza di questa interfaccia in un progetto a livello di documento, utilizzare la proprietà Controls di un elemento host Worksheet creata a livello di codice in fase di esecuzione. Per ulteriori informazioni, vedere Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione.

Nella tabella riportata di seguito viene illustrato come utilizzare i membri di ControlCollection per l'esecuzione di alcune attività comuni legate ai controlli nei documenti.

Task	Azione
Aggiungere un controllo al foglio di lavoro.	Utilizzare uno dei metodi Add<controllo>. Ad esempio, per aggiungere un oggetto Microsoft.Office.Tools.Excel.ListObject, utilizzare il metodo AddListObject.
Rimuovere un controlli dal foglio di lavoro.	Utilizzare il metodo Remove.
Determinare se un controllo è incluso nella raccolta.	Passare il controllo o il relativo nome al metodo Contains.
Ottenere l'indice di un controllo nell'insieme.	Passare il controllo o il relativo nome al metodo IndexOf.
Ottenere un controllo dalla raccolta.	Passare l'indice o il nome del controllo alla proprietà Item.

Nota

Questa interfaccia è implementata da Visual Studio Tools per Office Runtime. Non deve essere implementata nel codice. Per ulteriori informazioni, vedere Cenni preliminari su Visual Studio Tools per Office Runtime.

Utilizzo

Nella presente documentazione viene descritta la versione di questo tipo utilizzata nei progetti di Office destinati a .NET Framework 4. Nei progetti destinati a .NET Framework 3.5, questo tipo potrebbe avere membri diversi e gli esempi di codice forniti per il tipo potrebbero non funzionare. Per la documentazione relativa a questo tipo nei progetti destinati a .NET Framework 3.5, vedere la sezione di riferimento seguente nella documentazione di Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.Office.Tools.Excel

Share via