IConfigureToolboxItem Интерфейс

Определение

Предоставляет возможность настройки объектов ToolboxItem динамически путем добавления дополнительных данных в словарь свойств элемента панели инструментов. Эти данные затем сериализуются как постоянная часть элемента панели элементов.

public interface class IConfigureToolboxItem
public interface class IConfigureToolboxItem
__interface IConfigureToolboxItem
public interface IConfigureToolboxItem
type IConfigureToolboxItem = interface
Public Interface IConfigureToolboxItem

Комментарии

Этот интерфейс можно реализовать для любого создаваемого объекта, который не является производным от Package . Служба панели элементов вызывает ConfigureToolboxItem метод при первом добавлении нового элемента панели элементов на панель элементов.

Реализации этого интерфейса должны быть зарегистрированы. Регистрация состоит из следующих шагов:

  1. Регистрация определенного пакета VSPackage с целью предоставления конфигурации элемента панели инструментов.

    В среде управляемого пакета эта регистрация выполняется ProvideToolboxItemConfigurationAttribute .

    В приведенном ниже примере показано, как VSPackage MyPackage регистрирует ToolboxConfig класс в качестве реализации IConfigureToolboxItem :

    
                        [ProvideToolboxItemConfigurationAttribute(typeof(ToolboxConfig))]  
        [GuidAttribute("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")]  
        public class MyPackage : MSVSIP.Package {…}  
    
    
  2. Регистрация динамической конфигурации всех ToolboxItem объектов по указанным сборкам.

    В среде управляемых пакетов сборки, ToolboxItem объекты которых обрабатываются реализацией, IConfigureToolboxItem задаются путем применения ProvideAssemblyFilterAttribute к этой реализации IConfigureToolboxItem .

    В приведенном ниже примере ToolboxConfig класс регистрируется как обеспечивающий поддержку конфигурации для всех ToolboxItem объектов во всех сборках с Vsip пространством имен.

        [ProvideAssemblyFilterAttribute("Vsip.*, Version=*, Culture=*, PublicKeyToken=*")]  
        public sealed class ToolboxConfig : IConfigureToolboxItem {…}  
    

Примечание

Этот атрибут использует полную идентификацию сборки, включая простое имя, номер версии, пару криптографических ключей и поддерживаемый язык и региональные параметры. Дополнительные сведения об идентификации сборок см. в разделе AssemblyName. Символ "*" в спецификации принимается в качестве подстановочного знака.

Регистрация реализации IConfigureToolboxItem в составе пакета VSPackage изменяет параметры реестра в HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\ToolboxItemConfiguration и HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\CLSID , где <Version> — это версия Visual Studio , например 8,0.

Примечание

Корневой путь HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version> можно переопределить с помощью альтернативного корня при инициализации оболочки Visual Studio или с помощью DefaultRegistryRootAttribute . Дополнительные сведения о альтернативных корневых путях см. в разделе Параметры командной строки и DefaultRegistryRootAttribute .

Дополнительные сведения о содержимом этих записей реестра см. в разделе Регистрация компонентов поддержки панели элементов.

Примечания для тех, кто реализует этот метод

Реализуйте этот интерфейс, если необходимо динамически изменить характеристики элемента управления панели элементов , например, чтобы реагировать на присутствие или отсутствие определенных функций или объектов.

Методы этого интерфейса вызываются только при инициализации панели элементов .

Visual StudioСреде может потребоваться создать новый экземпляр реализаций IConfigureToolboxItem в любое время. Убедитесь, что выполнены следующие действия. — Всегда реализуйте IConfigureToolboxItem как открытый класс.

-Никогда не реализовывать IConfigureToolboxItem для класса, реализующего Package или IVsPackage .

Методы

ConfigureToolboxItem(ToolboxItem)

Вызывается службой панели элементов для настройки объектов ToolboxItem.

Применяется к