ProvideToolboxItemsAttribute Třída

Reference

Definice

Obor názvů:: Microsoft.VisualStudio.Shell

Sestavení:: Microsoft.VisualStudio.Shell.14.0.dll

Sestavení:: Microsoft.VisualStudio.Shell.15.0.dll

Balíček:: Microsoft.VisualStudio.Shell.15.0 v17.9.37000

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Použijte tento atribut na třídy implementují VSPackages k deklarování, pokud nabízejí sadu položek sady nástrojů sady 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

Dědičnost: Attribute

RegistrationAttribute
ProvideToolboxItemsAttribute

Atributy: AttributeUsageAttribute

Příklady

V následujícím příkladu atributy použité na třídu MyPackage indikují, že podporuje verze 1 položek sady nástrojů se dvěma formáty schránky "CF_XMLCODE" a "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

Poznámky

Kontext atributu


Platí pro	Třídy poskytující VSPackages implementací IVsPackage, . Package
Opakovatelnost	No
Požadované atributy	ProvideToolboxFormatAttribute
Neplatné atributy	Žádné

Použijte tento atribut na odvozenou Packagetřídu nebo třídu, která implementuje IVsPackage , která je vyžadována k povolení podpory pro uživatele přetáhnout datové objekty tohoto formátu, poskytované třídou, do sady nástrojů. Tato implementovat třída musí zpracovávat samotná oznámení o vyřazení.

Tento atribut se používá pouze pro účely registrace a nemá vliv na chování kódu za běhu.

V závislosti na argumentech zadaných v jeho konstruktoru může tento atribut znamenat, že balíček VSPackage neposkytuje žádné položky sady nástrojů . Pokud je atribut ProvideToolboxFormatAttribute přidán do třídy, aby indikovat, že poskytuje položky Toolbox , musí být také přidána jedna nebo více instancí ProvideToolboxFormatAttribute .

Tento atribut se používá ProvideToolboxFormatAttribute k registraci VSPackage jako poskytování položek panelu nástrojů v daném formátu.

Pokud tento atribut určuje, že jsou zadány položky panelu nástrojů , musí balíček VSPackage zpracovat ToolboxInitialized události a ToolboxUpgraded .

Jakákoli sada VSPackage používající tento atribut musí poskytovat obslužnou rutinu ToolboxInitialized pro události a ToolboxUpgraded .

Konstruktory

ProvideToolboxItemsAttribute(Int32)	Vytvoří novou instanci ProvideToolboxItemsAttribute , která označuje, jestli třída implementuje VSPackage poskytuje položky Sady nástrojů.
ProvideToolboxItemsAttribute(Int32, Boolean)	Inicializuje novou instanci ProvideToolboxItemsAttribute pro zadanou verzi.

Vlastnosti

NeedsCallBackAfterReset	Nastavení na hodnotu true vynutí událost ToolboxInitialized po každém resetování panelu nástrojů. To se dá použít při vývoji balíčku k tomu, aby sada nástrojů pokaždé požádala o seznam položek v balíčku (v případě, že se změnil). U dodávaných produktů je nejlepší nechat ji na false, aby bylo možné mezipaměť používat pro lepší výkon. V některých scénářích (například seznam položek, které nelze zachovat do mezipaměti) může být potřeba, aby byl tento příznak nastavený na hodnotu true.
TypeId	Přepište vlastnost TypeID, aby mohly odvozené třídy RegistrationAttribute pracovat s System.ComponentModel.TypeDescriptor.GetAttributes(...). Atribut odvozený z tohoto bude muset přepsat tuto vlastnost pouze v případě, že potřebuje lepší kontrolu nad instancemi, které lze použít na třídu. (Zděděno od RegistrationAttribute)
Version	Vlastnost vracející verzi položek sady nástrojů, které poskytuje sada VSPackage.

Metody

GetPackageRegKeyPath(Guid)	Získá cestu registru (vzhledem k kořenovému adresáři registru aplikace) VSPackage. (Zděděno od RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Zaregistruje balíček VSPackage jako zprostředkovatele položek sady nástrojů pro zadané formáty při zavolání externím registračním nástrojem, jako je regpkg.exe. Další informace najdete v tématu Registrace balíčků VSPackages.
Unregister(RegistrationAttribute+RegistrationContext)	Vrátí změny, které Register(RegistrationAttribute+RegistrationContext) metoda použila v registru.

Platí pro

Sdílet prostřednictvím