Click here to Skip to main content
15,867,686 members
Articles / Programming Languages / C#
Article

Deploying Controls to VS.NET ToolBox Programatically

Rate me:
Please Sign up or sign in to vote.
4.63/5 (13 votes)
1 Oct 2004CPOL3 min read 147.9K   581   39   40
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".

C#
//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:

C#
//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.

C#
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)


Written By
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

 
QuestionWhy "View.PropertiesWindow" ? Pin
ajproch13-Apr-05 5:19
ajproch13-Apr-05 5:19 
AnswerRe: Why "View.PropertiesWindow" ? Pin
Kannan.V13-Apr-05 6:52
Kannan.V13-Apr-05 6:52 
GeneralRe: Why "View.PropertiesWindow" ? Pin
ajproch13-Apr-05 10:21
ajproch13-Apr-05 10:21 
Generalthink you have a bug Pin
JCollum29-Dec-04 13:57
JCollum29-Dec-04 13:57 
Generalsomebody Pin
punk_ssa21-Dec-04 14:48
punk_ssa21-Dec-04 14:48 
GeneralRe: somebody Pin
Anonymous22-Dec-04 3:21
Anonymous22-Dec-04 3:21 
GeneralRe: somebody Pin
punk_ssa22-Dec-04 8:33
punk_ssa22-Dec-04 8:33 
GeneralRe: somebody Pin
Anonymous23-Dec-04 3:04
Anonymous23-Dec-04 3:04 
sounds a bit strange,
but anyways, not exactly sure why it does not want to add controls.
Are you running the app from within the visual studio environment,
If yes once u have added the controls, close the app and restart visual studio to see the controls that u added.
Also if u have added web controls, u might have to open the design view for the aspx page to show up the controls on the toolbox, similar case for the windows controls too...

Hope it works,
Kannan.V
GeneralRe: somebody Pin
punk_ssa23-Dec-04 6:20
punk_ssa23-Dec-04 6:20 
GeneralRe: somebody Pin
punk_ssa23-Dec-04 6:22
punk_ssa23-Dec-04 6:22 
Generals Pin
Anonymous10-Dec-04 18:16
Anonymous10-Dec-04 18:16 
GeneralTabs do not show up in IDE Pin
Grant Frisken8-Dec-04 13:44
Grant Frisken8-Dec-04 13:44 
GeneralRe: Tabs do not show up in IDE Pin
Grant Frisken8-Dec-04 17:29
Grant Frisken8-Dec-04 17:29 
GeneralRe: Tabs do not show up in IDE Pin
Grant Frisken8-Dec-04 19:13
Grant Frisken8-Dec-04 19:13 
GeneralRe: Tabs do not show up in IDE Pin
Kannan.V9-Dec-04 2:54
Kannan.V9-Dec-04 2:54 
GeneralRe: Tabs do not show up in IDE Pin
Grant Frisken9-Dec-04 10:56
Grant Frisken9-Dec-04 10:56 
GeneralRe: Tabs do not show up in IDE Pin
JCollum29-Dec-04 13:52
JCollum29-Dec-04 13:52 
GeneralMissing download Pin
Smitha Nishant3-Oct-04 20:30
protectorSmitha Nishant3-Oct-04 20:30 
GeneralRe: Missing download Pin
Kannan.V4-Oct-04 6:57
Kannan.V4-Oct-04 6:57 

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

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