Программное внедрение элементов управления в VS.NET ToolBox

В этой статье мы изучим процесс добавления заказных элементов управления и компонентов web/Windows в Visual Studio Toolbox используя код. Эта статья будет полезна для разработчиков элементов управления, которые хотят объединить их элементы управления с конкретным проектом. Таким образом, пользователь избавится от лишней работы, ссылаясь на элементы управления редактора Visual Studio и добавления их в Toolbox. Как только приложение будет запущено, оно автоматически добавит нужные элементы управления на Toolbox, так что разработчик сможет просто перетащить компоненты на страницу и легко использовать их.

Эта программа также может быть по выбору вызвана в процессе установки другой программы.

Описание

Эта статья предполагает знание основ Visual Studio 2003, программирования форм Windows в .NET Framework используя C# или Visual Basic .NET, и некоторых познаний в DTE.

Код

"DTE" является сокращением от "Development Tools Environment". Эта часть кода использует Reflection, чтобы создать образец Visual Studio .DTE.7.1. В Visual Studio объект DTE является корнем автоматизационной модели, которую в других объектных моделях зовут «Приложением».

//Класс EnvDTE не может быть проиллюстрирован новым ключевым словом

//вместо этого используем Reflection чтобы получить образец объекта DTE.

System.Type t = System.Type.GetTypeFromProgID("VisualStudio.DTE.7.1");

object obj = System.Activator.CreateInstance(t, true);

dteObject = (EnvDTE.DTE)obj;

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

Этот код показывает, как получить образец объекта окна, соответствующего Visual Studio Toolbox:

// получить образец объекта окна, соответствующего Visual Studio Toolbox

ToolBoxWnd = dteObject.Windows.Item(EnvDTE.Constants.vsWindowKindToolbox);

tlbTabs = ((ToolBox)ToolBoxWnd.Object).ToolBoxTabs;

Объект ToolBoxTabs обеспечивает набор методов и свойств для доступа к Toolbox и его набора элементов. Используя методы можно добавлять и удалять элементы из набора. Пример ниже создает новую закладку, используя имя, заданное пользователем и добавляет элементы управления, содержащиеся в файле DLL, заданном пользователем.

tlbTab = tlbTabs.Add("My New Tab");

ToolBoxWnd.Visible = true;

ToolBoxWnd.DTE.ExecuteCommand("View.PropertiesWindow","");

tlbTab.Activate();

tlbTab.ToolBoxItems.Item(1).Select();

tlbTab.ToolBoxItems.Add("My New Tab", "C:\MyControl.dll",

    vsToolBoxItemFormat.vsToolBoxItemFormatDotNETComponent);

Окно Toolbox должно быть сделано видимым и текущая закладка должна быть активирована прежде, чем любой из элементов управления будет добавлены на закладку, иначе элемент управления будет добавлен в закладку, открытую по умолчанию.

Метод add в ToolBoxItems принимает 3 параметра:

1. Имя закладки, куда элемент управления будет добавлен.
2. Путь к компоненте, добавляемой на toolbox (файл DLL).
3. Формат элемента toolbox; может быть элемент управления либо простой текстовый сегмент.

Демо-проект содержит UI, где пользователь может выбрать DLL файл, добавить или удалить элементы. Этот проект можно изменить, вырезав часть с UI, так что весь код для добавления и удаления элементов может быть записан в секцию form_load.

Таким образом, можно создать программу, которая будет выполняться в процессе инсталляции другой программы, и добавлять все элементы управления на toolbox.

Создание Setup-проекта

Откройте Visual Studio, выберите Setup and Deployment Project из списка доступных проектов, затем выберите Setup Project, выставите нужный путь к проекту, и затем откройте проект. Скопируйте все файлы проекта и все файлы DLLs в папку приложения; все зависимости будут автоматически определены и добавлены.

Щелкните по редактору Custom Actions в окне Solution Explorer. Слева внизу откроются по умолчанию четыре действия для инсталлятора: Install, Commit, Rollback и Uninstall.

Щелкните правой клавишей по Install и выберите Add Custom Action, это откроет диалоговое окно с выбором файла, соответствующим заказным действиям. Выберите исполняемый файл "AddToToolBar.exe" и добавьте его. После его добавления, установите свойство CustomInstaller для добавленного файла в "False". Это запустит наш EXE-файл из инсталлятора.

Скомпилируйте Setup-проект и пакет элементов управления готов к внедрению.

Автор: Kannan V 16 Feb 2004. Перевод: MC707 18 Jan 2005 для REALCODING.NET