IConfigureToolboxItem Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет возможность настройки объектов ToolboxItem динамически путем добавления дополнительных данных в словарь свойств элемента панели инструментов. Эти данные затем сериализуются как постоянная часть элемента панели элементов.
public interface class IConfigureToolboxItem
public interface class IConfigureToolboxItem
__interface IConfigureToolboxItem
public interface IConfigureToolboxItem
type IConfigureToolboxItem = interface
Public Interface IConfigureToolboxItem
Комментарии
Этот интерфейс можно реализовать для любого создаваемого объекта, который не является производным от Package . Служба панели элементов вызывает ConfigureToolboxItem метод при первом добавлении нового элемента панели элементов на панель элементов.
Реализации этого интерфейса должны быть зарегистрированы. Регистрация состоит из следующих шагов:
Регистрация определенного пакета VSPackage с целью предоставления конфигурации элемента панели инструментов.
В среде управляемого пакета эта регистрация выполняется ProvideToolboxItemConfigurationAttribute .
В приведенном ниже примере показано, как VSPackage
MyPackageрегистрируетToolboxConfigкласс в качестве реализации IConfigureToolboxItem :[ProvideToolboxItemConfigurationAttribute(typeof(ToolboxConfig))] [GuidAttribute("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")] public class MyPackage : MSVSIP.Package {…}Регистрация динамической конфигурации всех 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. |