IConfigureToolboxItem, interface

Article
08/01/2012

Fournit la possibilité de configurer des objets d'ToolboxItem dynamiquement en ajoutant des informations supplémentaires au dictionnaire des propriétés de l'élément de boîte à outils.Cette donnée est alors sérialisée en tant que partie intégrante de l'élément de boîte à outils.

Espace de noms : Microsoft.VisualStudio.Shell
Assembly : Microsoft.VisualStudio.Shell.11.0 (dans Microsoft.VisualStudio.Shell.11.0.dll)

Syntaxe

'Déclaration
Public Interface IConfigureToolboxItem

public interface IConfigureToolboxItem

Le type IConfigureToolboxItem expose les membres suivants.

Méthodes

	Nom	Description
	ConfigureToolboxItem	Appelé par le service de boîte à outils pour configurer des objets d'ToolboxItem.

Début

Remarques

Cette interface peut être implémentée sur tout objet créé qui ne dérive pas d'Package.Le service de boîte à outils appellera la méthode d'ConfigureToolboxItem lorsqu'un nouvel élément de boîte à outils est premier ajouté à la boîte à outils.

Les implémentations de cette interface doivent être enregistrées.L'alignement inclut les étapes suivantes :

Enregistrant un VSPackage particulière en tant que fourniture de la configuration d'élément de boîte à outils.

Sous l'infrastructure managée de package, cet alignement est effectué par ProvideToolboxItemConfigurationAttribute.

L'exemple ci-dessous des spectacles comment le VSPackage MyPackage enregistre la classe d'ToolboxConfig comme implémentation d'IConfigureToolboxItem :
```
    [ProvideToolboxItemConfigurationAttribute(typeof(ToolboxConfig))]
    [GuidAttribute("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")]
    public class MyPackage : MSVSIP.Package {…}
```
Enregistrer la configuration dynamique de tous les objets d'ToolboxItem par les assemblys spécifiés.

Sous l'infrastructure managée de package, les assemblys dont les objets d'ToolboxItem sont traités par une implémentation d'IConfigureToolboxItem sont spécifiés en appliquant ProvideAssemblyFilterAttribute à cette implémentation d'IConfigureToolboxItem.

L'exemple suivant enregistre la classe d'ToolboxConfig comme fournir à la prise en charge de configuration pour tous les objets d'ToolboxItem dans tous les assemblys l'espace de noms d'Vsip.
```
    [ProvideAssemblyFilterAttribute("Vsip.*, Version=*, Culture=*, PublicKeyToken=*")]
    public sealed class ToolboxConfig : IConfigureToolboxItem {…}
```

[!REMARQUE]

Cet attribut utilise l'identification complète d'assembly, y compris un nom simple, un numéro de version, une paire de clé de chiffrement, et une culture prise en charge.Pour plus d'informations sur l'identification d'assembly, consultez l'AssemblyName.« * » Le personnage dans une spécification est pris en tant que caractère générique.

Enregistrant une implémentationIConfigureToolboxItem de dans le cadre d'un VSPackage modifie des paramètres du Registre sousHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\ToolboxItemConfiguration etHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\CLSID, où le <Version> estVisual Studio la version, par exemple 8,0.

[!REMARQUE]

Le chemin d'accès racine d'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version> peut être substitué avec une autre racine lorsque le shell de Visual Studio est initialisé, ou avec DefaultRegistryRootAttribute.Pour plus d'informations sur d'autres chemins d'accès racine, consultez Commutateurs de la ligne de commande (Kit de développement logiciel Visual Studio) et l'DefaultRegistryRootAttribute.

Pour plus d'informations sur le contenu de ces entrées du Registre, consultez Stocker des fonctionnalités de prise en charge de la boîte à outils.

Remarques à l'attention des implémenteurs

Implémentez cette interface lorsque vous devez modifier les caractéristiques d'un contrôle de boîte à outils dynamiquement, par exemple en fonction de la présence ou l'absence de certains fonctionnalités ou objets.

Les méthodes de cette interface sont appelées uniquement lorsque boîte à outils est initialisé.

L'environnement de Visual Studio peut avoir à créer une nouvelle instance des implémentations d'IConfigureToolboxItem à tout moment.Vérifiez les point suivants :

Implémentez toujours IConfigureToolboxItem comme classe public.
N'implémentez jamais IConfigureToolboxItem sur une classe implémentant Package ou IVsPackage.