Condividi tramite


ProvideToolboxItemsAttribute Classe

Definizione

Applicare questo attributo alle classi che implementano VSPackage per dichiarare se offrono un set di elementi alla casella degli strumenti di Visual Studio.

public ref class ProvideToolboxItemsAttribute : Microsoft::VisualStudio::Shell::RegistrationAttribute
[System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)]
public class ProvideToolboxItemsAttribute : Microsoft.VisualStudio.Shell.RegistrationAttribute
[<System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)>]
type ProvideToolboxItemsAttribute = class
    inherit RegistrationAttribute
Public Class ProvideToolboxItemsAttribute
Inherits RegistrationAttribute
Ereditarietà
ProvideToolboxItemsAttribute
Attributi

Esempio

Nell'esempio seguente gli attributi applicati alla classe MyPackage indicano che supporta la versione 1 degli elementi della casella degli strumenti di con due formati "CF_XMLCODE" e "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  

Commenti

Contesto attributo

Si applica a Classi che forniscono PACCHETTI VSPackage implementando IVsPackage, Package.
Ripetibile No
Attributi richiesti ProvideToolboxFormatAttribute
Attributi non validi Nessuno

Applicare questo attributo a una Packageclasse derivata da -o a una classe che implementa IVsPackage che è necessaria per consentire agli utenti di trascinare gli oggetti dati di questo formato, forniti dalla classe , nella casella degli strumenti. Questa classe di implementazione deve gestire le notifiche di rilascio.

Questo attributo viene usato solo a scopo di registrazione e non influisce sul comportamento del codice in fase di esecuzione.

A seconda degli argomenti specificati nel relativo costruttore, questo attributo può indicare che un VSPackage non fornisce elementi della casella degli strumenti . Se l'attributo ProvideToolboxFormatAttribute viene aggiunto a una classe per indicare che fornisce elementi della casella degli strumenti , è necessario aggiungere anche una o più istanze di ProvideToolboxFormatAttribute .

Questo attributo usa ProvideToolboxFormatAttribute per registrare un VSPackage come specificare gli elementi della casella degli strumenti di un determinato formato.

Se questo attributo specifica che vengono forniti gli elementi della casella degli strumenti , il VSPackage deve gestire gli ToolboxInitialized eventi e ToolboxUpgraded .

Qualsiasi VSPackage che usa questo attributo deve fornire un gestore per gli ToolboxInitialized eventi e ToolboxUpgraded .

Costruttori

ProvideToolboxItemsAttribute(Int32)

Crea una nuova istanza di ProvideToolboxItemsAttribute che indica se una classe che implementa un VSPackage fornisce elementi della casella degli strumenti.

ProvideToolboxItemsAttribute(Int32, Boolean)

Inizializza una nuova istanza di ProvideToolboxItemsAttribute per la versione specificata.

Proprietà

NeedsCallBackAfterReset

Se si imposta su true, verrà forzato un evento ToolboxInitialized dopo ogni reimpostazione della casella degli strumenti. Questa opzione può essere usata durante lo sviluppo del pacchetto per forzare la casella degli strumenti a chiedere l'elenco di elementi al pacchetto ogni volta (nel caso in cui sia stata modificata). Per i prodotti spediti, è consigliabile lasciarlo false in modo che la cache possa essere usata per prestazioni migliori. Alcuni scenari, ad esempio l'elenco di elementi che non possono essere salvati in modo permanente nella cache, potrebbero dover impostare questo flag su true

TypeId

Eseguire l'override della proprietà TypeID per consentire alle classi derivate RegistrationAttribute di usare System.ComponentModel.TypeDescriptor.GetAttributes(...). Un attributo derivato da questo deve eseguire l'override di questa proprietà solo se necessita di un controllo migliore sulle istanze che possono essere applicate a una classe.

(Ereditato da RegistrationAttribute)
Version

Proprietà che restituisce la versione degli elementi della casella degli strumenti forniti da un VSPackage.

Metodi

GetPackageRegKeyPath(Guid)

Ottiene il percorso del Registro di sistema (relativo alla radice del Registro di sistema dell'applicazione) del pacchetto VS.

(Ereditato da RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)

Registra un VSPackage come provider di elementi della casella degli strumenti per i formati specificati quando viene chiamato da uno strumento di registrazione esterno, ad esempio regpkg.exe. Per altre informazioni, vedere Registrazione di PACCHETTI VSPackage.

Unregister(RegistrationAttribute+RegistrationContext)

Inverte le modifiche apportate dal metodo di Register(RegistrationAttribute+RegistrationContext) al Registro di sistema.

Si applica a