ControlCollection, interface
Représente une collection de contrôles managés sur une feuille de travail Excel dans une solution Office.
Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)
Syntaxe
'Déclaration
<GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")> _
Public Interface ControlCollection _
Inherits IEnumerable
[GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")]
public interface ControlCollection : IEnumerable
Le type ControlCollection expose les membres suivants.
Propriétés
| Nom | Description | |
|---|---|---|
.gif "Propriété publique") |
Count | Obtient le nombre de contrôles contenus dans ControlCollection. |
|
Item[Int32] | Obtient le contrôle correspondant à l'index spécifié. |
|
Item[String] | Obtient le contrôle portant le nom spécifié. |
Début
Méthodes
| Nom | Description | |
|---|---|---|
.gif "Méthode publique") |
AddChart(Range, String) | Ajoute un nouveau contrôle Chart à la feuille de calcul à la plage spécifiée. |
|
AddChart(Double, Double, Double, Double, String) | Ajoute un nouveau contrôle Chart à la feuille de calcul selon la taille et l'emplacement spécifiés. |
|
AddControl(Control, Range, String) | Ajoute le Control spécifié à ControlCollection à la plage spécifiée. |
|
AddControl(Control, Double, Double, Double, Double, String) | Ajoute le Control spécifié à ControlCollection selon l'emplacement et la taille spécifiés. |
|
AddListObject(ListObject) | Ajoute un Microsoft.Office.Tools.Excel.ListObject Visual Studio à la collection de contrôles en fonction du Microsoft.Office.Interop.Excel.ListObject natif spécifié. |
|
AddListObject(Range, String) | Ajoute un nouveau contrôle ListObject à la feuille de calcul à la plage spécifiée. |
|
AddNamedRange | Ajoute un nouveau contrôle NamedRange à la feuille de calcul à la plage spécifiée. |
|
Contains(Object) | Détermine si le contrôle spécifié est membre de l'instance de ControlCollection. |
|
Contains(String) | Détermine si un contrôle portant le nom spécifié est membre de l'instance de ControlCollection. |
|
GetEnumerator | Retourne un énumérateur qui itère au sein d'une collection. (Hérité de IEnumerable.) |
|
IndexOf(Object) | Recherche le contrôle spécifié et retourne l'index de base zéro de la première occurrence dans l'instance de ControlCollection. |
|
IndexOf(String) | Recherche la première occurrence d'un contrôle portant le nom spécifié dans l'instance de ControlCollection. |
|
Remove(Object) | Supprime le contrôle spécifié de l'instance de ControlCollection. |
|
Remove(String) | Supprime le contrôle portant le nom spécifié de l'instance de ControlCollection. |
|
RemoveAt | Supprime le contrôle à l'index spécifié dans l'instance de ControlCollection. |
Début
Notes
Utilisez les méthodes et propriétés de l'interface ControlCollection pour gérer des contrôles sur une feuille de calcul Excel. Pour plus d'informations, consultez Ajout de contrôles à des documents Office au moment de l'exécution.
Vous ne pouvez pas créer une instance de cette interface dans votre code, car elle n'a pas de constructeurs publics. Pour obtenir une instance de cette interface dans un projet au niveau du document, utilisez la propriété Controls de l'une des classes Sheetn dans votre projet. Pour obtenir une instance de cette interface dans un projet au niveau du document, utilisez la propriété Controls d'un élément hôte Worksheet que vous créez par programmation au moment de l'exécution. Pour plus d'informations, consultez Extension de documents Word et de classeurs Excel dans des compléments d'application au moment de l'exécution..
Le tableau suivant indique comment utiliser des membres ControlCollection pour effectuer quelques tâches courantes en rapport avec les contrôles sur les documents.
Tâche |
Action |
|---|---|
Ajoutez un contrôle à la feuille de calcul. |
Utilisez l'une des méthode Ajouter<control>. Par exemple, pour ajouter un Microsoft.Office.Tools.Excel.ListObject, utilisez la méthode AddListObject. |
Supprimez un contrôle de la feuille de calcul. |
Utilisez la méthode Remove. |
Déterminez si un contrôle est dans la collection. |
Passez le contrôle ou son nom à la méthode Contains. |
Index du contrôle dans la collection. |
Passez le contrôle ou son nom à la méthode IndexOf. |
Obtenez un contrôle de la collection. |
Passez l'index ou le nom du contrôle à la propriété Item. |
Notes
Cette interface est implémentée par Visual Studio Tools pour Office Runtime. Elle n'est pas destinée à être implémentée dans votre code. Pour plus d'informations, consultez Vue d'ensemble de Visual Studio Tools pour Office Runtime.
Utilisation
Cette documentation décrit la version de ce type utilisée dans les projets Office qui ciblent .NET Framework 4. Dans les projets qui ciblent .NET Framework 3.5, ce type peut contenir d'autres membres, et les exemples de code qui y figurent sont susceptibles de ne pas fonctionner. Pour obtenir de la documentation sur ce type dans les projets ciblant .NET Framework 3.5, consultez la section de référence suivante dans la documentation Visual Studio 2008 : https://go.microsoft.com/fwlink/?LinkId=160658.