Classe ProvideToolboxItemsAttribute

  • Articolo

Applicare questo attributo alle classi che implementano Vspackage per dichiarare se offrono un insieme di elementi a Visual Studio Casella degli strumenti.

Gerarchia di ereditarietà

System.Object
  System.Attribute
    Microsoft.VisualStudio.Shell.RegistrationAttribute
      Microsoft.VisualStudio.Shell.ProvideToolboxItemsAttribute

Spazio dei nomi:  Microsoft.VisualStudio.Shell
Assembly:  Microsoft.VisualStudio.Shell.11.0 (in Microsoft.VisualStudio.Shell.11.0.dll)

Sintassi

'Dichiarazione
<AttributeUsageAttribute(AttributeTargets.Class, Inherited := True)> _
Public Class ProvideToolboxItemsAttribute _
    Inherits RegistrationAttribute

[AttributeUsageAttribute(AttributeTargets.Class, Inherited = true)]
public class ProvideToolboxItemsAttribute : RegistrationAttribute

Il tipo ProvideToolboxItemsAttribute espone i seguenti membri.

Costruttori

  Nome Descrizione
Metodo pubblico ProvideToolboxItemsAttribute(Int32) Crea una nuova istanza di ProvideToolboxItemsAttribute che indica se una classe che implementa un VSPackage produce gli elementi di Casella degli strumenti .
Metodo pubblico ProvideToolboxItemsAttribute(Int32, Boolean) inizializza una nuova istanza di ProvideToolboxItemsAttribute per la versione specificata.

In alto

Proprietà

  Nome Descrizione
Proprietà pubblica NeedsCallBackAfterReset Ottiene o imposta se l'evento di ToolboxInitialized deve essere generato dopo ogni reimpostazione della casella degli strumenti.
Proprietà pubblica TypeId Ottiene l'istanza corrente dell'attributo. (Ereditato da RegistrationAttribute)
Proprietà pubblica Version Proprietà che restituisce la versione degli elementi di Casella degli strumenti un VSPackage fornisce.

In alto

Metodi

  Nome Descrizione
Metodo pubblico Equals Infrastruttura. Restituisce un valore che indica se l'istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
Metodo protetto Finalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulitura prima che l'oggetto stesso venga recuperato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblico GetHashCode Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
Metodo protetto GetPackageRegKeyPath Ottiene il percorso del Registro di sistema (relativo alla chiave radice del Registro di sistema dell'applicazione) del pacchetto VS. (Ereditato da RegistrationAttribute)
Metodo pubblico GetType Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblico IsDefaultAttribute Una volta sottoposto a override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Metodo pubblico Match Una volta sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
Metodo protetto MemberwiseClone Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo pubblico Register Registra un VSPackage come provider dell'elemento di Casella degli strumenti per i formati specifici quando viene chiamato da uno strumento esterno di registrazione come regpkg.exe.Per ulteriori informazioni, vedere Registrare package VS.. (Esegue l'override di RegistrationAttribute.Register(RegistrationAttribute.RegistrationContext)).
Metodo pubblico ToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Metodo pubblico Unregister Inverte le modifiche apportate dal metodo di Register ha applicato al Registro di sistema. (Esegue l'override di RegistrationAttribute.Unregister(RegistrationAttribute.RegistrationContext)).

In alto

Implementazioni esplicite dell'interfaccia

  Nome Descrizione
Implementazione esplicita dell'interfacciaMetodo privato _Attribute.GetIDsOfNames Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch. (Ereditato da Attribute)
Implementazione esplicita dell'interfacciaMetodo privato _Attribute.GetTypeInfo Recupera le informazioni sui tipi per un oggetto, che può essere utilizzato per ottenere informazioni sul tipo per un'interfaccia. (Ereditato da Attribute)
Implementazione esplicita dell'interfacciaMetodo privato _Attribute.GetTypeInfoCount Recupera il numero di interfacce di informazioni sui tipi che un oggetto garantisce (0 o 1). (Ereditato da Attribute)
Implementazione esplicita dell'interfacciaMetodo privato _Attribute.Invoke Fornisce l'accesso a proprietà e metodi esposti da un oggetto. (Ereditato da Attribute)

In alto

Note

contesto di attributo

si applica a

Classi che forniscono Vspackage distribuzione IVsPackage, Package.

ripetibile

no

attributi obbligatori

ProvideToolboxFormatAttribute

attributi non validi

nessuno

Applicare questo attributo a Packageclasse derivata da o classe che implementano IVsPackage che è necessario abilitare il supporto per gli utenti di trascinare oggetti dati di questo formato, se dalla classe, in Casella degli strumenti.Questa classe di implementazione necessario gestire le notifiche di trascinamento stessa.

Questo attributo viene utilizzato solo per scopi di registrazione e non influisce sul codice si comporta in fase di esecuzione.

A seconda degli argomenti specificati nel relativo costruttore, l'attributo può indicare che un VSPackage non fornisce alcuni elementi di Casella degli strumenti .Se l'attributo ProvideToolboxFormatAttribute viene aggiunto a una classe per indicare che fornisce elementi di Casella degli strumenti , uno o più istanze di ProvideToolboxFormatAttribute devono inoltre essere aggiunti.

Questo attributo viene utilizzato ProvideToolboxFormatAttribute per registrare un VSPackage come fornendo gli elementi di Casella degli strumenti di un formato specificato.

Se questo attributo specifica che gli elementi di Casella degli strumenti inclusi, il package VS necessario gestire gli eventi di ToolboxUpgraded e di ToolboxInitialized .

Tutto il package VS utilizzando questo attributo deve fornire un gestore per gli eventi di ToolboxUpgraded e di ToolboxInitialized .

Esempi

Nell'esempio riportato di seguito, gli attributi applicati alla classe MyPackage indica che supporta la versione 1 degli elementi di Casella degli strumenti con due formati degli Appunti “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

Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.VisualStudio.Shell