Click here to Skip to main content
Click here to Skip to main content

Deploying Controls to VS.NET ToolBox Programatically

, 1 Oct 2004
Rate this:
Please Sign up or sign in to vote.
This article explains on how to deploy custom controls and components to a particular tab in Visual Studio Toolbox programatically. This can be used with installer programs for automatic deployment.

Sample Image - AddItemToToolBar.jpg

Introduction

In this article, we will walk through the process of adding custom web/Windows controls and components to the Visual Studio Toolbox, using code. This article will be helpful for control developers who want to deploy their controls into a single package to clients. The client need not have to do the extra work of referencing the controls from the Visual Studio editor and adding it to the Toolbox. Once this application is run, it automatically adds all the controls to the Toolbox, and the developer can drag and drop the components on to the page and use it.

The executable can be called from an installer program as a custom action also.

Background

This article assumes a basic familiarity with Visual Studio 2003, Windows Forms programming in the .NET Framework using C# or Visual Basic .NET, and some basics into the mechanism of Reflection and DTE concepts.

The Code

This piece of code actually uses Reflection to create an instance of Visual Studio .DTE.7.1. In Visual Studio, the DTE object is the root of the automation model, which other object models often call "Application". "DTE" is an acronym that stands for "Development Tools Environment".

//EnvDTE class cannot be instantiated using the new keyword
//instead use Reflection to get an instance of the DTE Object.
System.Type t = System.Type.GetTypeFromProgID("VisualStudio.DTE.7.1"); 
object obj = System.Activator.CreateInstance(t, true); 
dteObject = (EnvDTE.DTE)obj;

Once an object of DTE is obtained, all methods and properties for the particular type can be accessed, and using these properties and methods, we will be adding the items to the toolbox.

This code block shows us how to get an instance of the window object corresponding to the Visual Studio Toolbox:

//Gets the window Object corrsponding to the visual Studio Toolbox

ToolBoxWnd = dteObject.Windows.Item(EnvDTE.Constants.vsWindowKindToolbox);
tlbTabs = ((ToolBox)ToolBoxWnd.Object).ToolBoxTabs;

The ToolBoxTabs object provides a set of methods and properties to access the Toolbox and its Items collection. Using the methods, new items can be added or deleted form the collection. The code sample below creates a new tab using the name specified by the user and adds the controls contained inside the DLL file loaded by the user.

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);

The toolbox window has to be made visible and the current toolbox tab has to be activated before any controls can be loaded to the tab, else the controls will get added to the default tab.

The add method of the ToolBoxItems takes 3 parameters:

  1. Name of the tab to which the controls are to be added.
  2. Path to the component to be added to the toolbox (DLL file).
  3. The format for the toolbox item, can be a control or a simple text segment.

The demo project includes a UI where the user can choose a DLL file to load and can add or delete items. The project can be modified to strip off all the UI part with just a basic form, and all the code for adding the items can be written in the form_load section.

Create an executable file with this application and the EXE can be used with an installer program that runs this executable which in turn adds all the controls to the toolbox.

Creating a Setup and Deployment Project

Open Visual Studio and select Setup and Deployment Project from the New Project screen, and select Setup Project, provide it with a location, and open the project. Copy all application files and DLLs to the application folder; dependencies are automatically detected and added.

Setup Screen

Click Custom Actions editor from the Solution Explorer window, the left pane will now show four default actions for the installer: Install, Commit, Rollback and Uninstall.

Setup ScreenShot

Right click on Install and select Add Custom Action, this opens up a dialog box to add a custom action file, select the executable file "AddToToolBar.exe" and add the file. After adding the file, set the CustomInstaller property for the added file to "False". This should invoke the EXE file from the installer.

Setup Screenshot

Build the Setup project and the controls package is ready to be deployed.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

About the Author

Kannan.V
Web Developer
United States United States
Kannan has 4+ years of experience in software development, he started his career in VB and asp application development and as new technologies evolved, he felt the need to make use of the advanced functionalities, develop complex applications and take up challenging tasks, it was then when he started falling in love with the DotNet architecture and concepts which really enthralled him do do more projects in dotnet and get to use the full potential of DotNet. He specialises in development of Custom controls and components and tools. He is a Microsoft Certified Applications Developer working with a Fortune 500 Giant in Bangalore, India
 
Kannan is a fun loving person, likes to wander around in the hills, sometimes he gets glued to the computer doing some serious stuff or trying to get something to work. More information about him is available on his site.
 
Visit my Blog at http://kannanv.blogspot.com
 

Comments and Discussions

 
QuestionHow to Load WPF Custom controls programatically to the toolBox? PinmemberBharathGandhi16-Feb-09 17:39 
AnswerRe: How to Load WPF Custom controls programatically to the toolBox? PinmemberKannan.V17-Feb-09 8:39 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web04 | 2.8.140721.1 | Last Updated 2 Oct 2004
Article Copyright 2004 by Kannan.V
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid