ProvideToolboxItemsAttribute, classe
Appliquez-vous cet attribut aux classes implémentant des VSPackages pour déclarer s'ils offrent un ensemble d'éléments à Visual Studioboîte à outils.
Hiérarchie d'héritage
System.Object
System.Attribute
Microsoft.VisualStudio.Shell.RegistrationAttribute
Microsoft.VisualStudio.Shell.ProvideToolboxItemsAttribute
Espace de noms : Microsoft.VisualStudio.Shell
Assembly : Microsoft.VisualStudio.Shell.11.0 (dans Microsoft.VisualStudio.Shell.11.0.dll)
Syntaxe
'Déclaration
<AttributeUsageAttribute(AttributeTargets.Class, Inherited := True)> _
Public Class ProvideToolboxItemsAttribute _
Inherits RegistrationAttribute
[AttributeUsageAttribute(AttributeTargets.Class, Inherited = true)]
public class ProvideToolboxItemsAttribute : RegistrationAttribute
Le type ProvideToolboxItemsAttribute expose les membres suivants.
Constructeurs
| Nom | Description | |
|---|---|---|
.gif "Méthode publique") |
ProvideToolboxItemsAttribute(Int32) | Crée une nouvelle instance d'ProvideToolboxItemsAttribute qui indique si une classe implémentant un VSPackage fournit des éléments de boîte à outils. |
|
ProvideToolboxItemsAttribute(Int32, Boolean) | Initialise une nouvelle instance d'ProvideToolboxItemsAttribute pour la version spécifiée. |
Début
Propriétés
| Nom | Description | |
|---|---|---|
.gif "Propriété publique") |
NeedsCallBackAfterReset | Obtient ou définit si l'événement d'ToolboxInitialized doit être déclenché après chaque réinitialisation de boîte à outils. |
|
TypeId | Obtient l'instance actuel de cet attribut. (Hérité de RegistrationAttribute.) |
|
Version | Propriété retournant la version des éléments de boîte à outils qu'un VSPackage le fournit. |
Début
Méthodes
| Nom | Description | |
|---|---|---|
|
Equals | Infrastructure. Retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute.) |
.gif "Méthode protégée") |
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
GetHashCode | Retourne le code de hachage de cette instance. (Hérité de Attribute.) |
|
GetPackageRegKeyPath | Obtient le chemin d'accès au Registre (par rapport à la racine de Registre de l'application) du VSPackage. (Hérité de RegistrationAttribute.) |
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
IsDefaultAttribute | En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute.) |
|
Match | En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute.) |
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.) |
|
Register | Enregistre un VSPackage comme fournisseur d'élément de boîte à outils pour des formats spécifiés une fois appelé par un outil externe d'alignement tel que regpkg.exe.Pour plus d'informations, consultez Stocker les VSPackages. (Substitue RegistrationAttribute.Register(RegistrationAttribute.RegistrationContext).) |
|
ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
|
Unregister | Inverse les modifications que la méthode d'Register s'était appliquées au Registre. (Substitue RegistrationAttribute.Unregister(RegistrationAttribute.RegistrationContext).) |
Début
Implémentations d'interface explicite
| Nom | Description | |
|---|---|---|
.gif "Implémentation d'interface explicite") .gif "Méthode privée") |
_Attribute.GetIDsOfNames | Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute.) |
|
_Attribute.GetTypeInfo | Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface. (Hérité de Attribute.) |
|
_Attribute.GetTypeInfoCount | Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute.) |
|
_Attribute.Invoke | Fournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute.) |
Début
Remarques
Contexte d'attribut
S'applique à |
Classes fournissant des VSPackages en implémentant IVsPackage, Package. |
Reproductible |
Non |
Attributs requis |
|
Attributs valides |
Aucun |
Appliquez-vous cet attribut à Package - classe dérivée ou une classe qui implémente IVsPackage qui est requis pour permettre la prise en charge des utilisateurs pour faire glisser des objets de données de ce format, si par la classe, sur boîte à outils.Cette classe implémentante doit traiter les notifications de déplacement elle-même.
Cet attribut est seulement utilisé pour l'alignement, et n'affecte pas comment code se comporte pendant l'exécution.
Selon les arguments spécifiés dans son constructeur, cet attribut peut indiquer qu'un VSPackage ne fournit aucun élément de boîte à outils.Si l'attribut ProvideToolboxFormatAttribute est ajouté à une classe pour indiquer qu'il fournit des éléments de boîte à outils, une ou plusieurs instances d'ProvideToolboxFormatAttribute doivent également être ajoutées.
Cet attribut utilise ProvideToolboxFormatAttribute pour enregistrer un VSPackage comme fournissant des éléments de boîte à outils d'un format donné.
Si cet attribut spécifie que des éléments de boîte à outils sont fournis, le VSPackage doit gérer les événements d'ToolboxInitialized et d'ToolboxUpgraded.
Tout VSPackage à l'aide de cet attribut doit fournir un gestionnaire pour les événements d'ToolboxInitialized et d'ToolboxUpgraded.
Exemples
Dans l'exemple ci-dessous, les attributs appliqués à la classe MyPackage indique qu'elle prend en charge la version 1 des éléments de boîte à outils de avec deux formats de presse-papiers « CF_XMLCODE » et « InPlaceMenuEditorMenu ».
[DefaultRegistryRoot("Software\\Microsoft\\VisualStudio\\8.0")]
[ProvideToolboxItems(true, 1)]
[ProvideToolboxFormat("CF_XMLCODE")]
[ProvideToolboxFormat("InPlaceMenuEditorMenu")]
[Guid("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")]
internal sealed class MyPackage : Package
Sécurité des threads
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.