Click here to Skip to main content
15,860,972 members
Articles / Programming Languages / Visual Basic
Article

Useful enhancements for Visual Studio .NET

Rate me:
Please Sign up or sign in to vote.
4.95/5 (100 votes)
1 Jul 200310 min read 1.3M   21.9K   284   380
Several tools packed into one addin for Visual Studio .NET

Kings Tools

Kings Tools

Introduction

As good as Visual Studio .NET is, I still miss some features in it. But MS knew that they couldn't fulfill every wish so they provided a way to write addins. That's what I've done. Sure, most of the functions in my Tools could also be done with macros, but I wanted them all packed together with an installer.

Tools

  • Run Doxygen
  • Insert Doxygen comments
  • Build Solution stats
  • Dependency Graph
  • Inheritance Graph
  • Swap .h<->.cpp
  • Colorize
  • } End of
  • #region/#endregion for c++
  • Search the web

Run Doxygen

This command first pops up a dialog box in which you can configure the output Doxygen should produce. For those who don't know Doxygen: it's a free tool to generate source documentations. It can produce documentation in different formats like html and even windows help format! See http://www.doxygen.org/ for details. Since the dialog box doesn't offer all possible settings for doxygen, you can always edit the file Doxyfile.cfg manually which is created the first time you run it. All settings in that file override the settings you enter in the dialog box.

Doxygen configuration dialog

If you set Doxygen to generate html output, the resulting index.html is opened inside the IDE. A winhelp output (index.chm) will be opened outside the IDE.

The command available from the Tools menu builds the documentation for the whole solution. If you don't want that for example if you have several third party projects in your solution then you can build the documentation also for single projects. To do that the KingsTools add a command to the right click menu in the solution explorer.

If you want to update Doxygen to a newer version (as soon as one is released) simply overwrite the doxygen.exe in the installation directory. The same applies to the dot.exe.

TODO: find a way to integrate the generated windows help file into VS help.

Insert Doxygen comments

Doxygen needs comments that follow certain conventions to build documentation from. This part of the tools inserts them for you. Either from the right click menu in the code editor window or from the submenu under Tools->Kings Tools. Just place the caret over a method or class header. The inserted comment for a method or function would look like this:

/**
 *
 * \param one
 * \param two
 * \param three
 * \return
 */
BOOL myfunction(int one, int two, int three);

You now have to simply insert a description in the second comment line and descriptions for each parameter of the function/method. And of course a description of the return value.

You can customize the function comments by editing the files "functionheadertop.txt", "functionparams.txt" and "functionheaderbottom.txt". Please read the comments inside those files on how to do that. If you don't want to change the function comments for all your projects then you can place any of those files into your project directory (that way it will be used for your project) or inside the folder of your source files (that way it will be used only for the files inside that specific folder).

The inserted comment for a class looks like this:

/**
 * \ingroup projectname
 *
 * \par requirements
 * win98 or later, win2k or later, win95 with IE4 or later, winNT4 with IE4 
 * or later
 *
 * \author user
 *
 * \par license
 * This code is absolutely free to use and modify. The code is provided 
 * "as is" with no expressed or implied warranty. The author accepts no 
 * liability if it causes any damage to your computer, causes your pet to 
 * fall ill, increases baldness or makes your car start emitting strange 
 * noises when you start it up. This code has no bugs, just undocumented 
 * features!
 *
 * \version 1.0
 * \date 06-2002
 * \todo
 * \bug
 * \warning
 *
 */
class CRegBase

The '\ingroup projectname' means that the class is inside the project 'projectname'. That statement helps Doxygen to group classes together. Insert the description of the class right after that statement. If you want to include pictures to illustrate the class, use '\image html "picture.jpg"'. For more helpful tags you can use please check out the Doxygen website. The '\par requirements' section you have to modify yourself to fit the truth of your class. It's not necessary for Doxygen, but I found it very useful to give that information inside a class documentation. The name after the '\author' tag is the currently logged in user. Maybe you want to change that too to include an email address.

You can customize the class comments by editing the file "classheader.txt" Please read the comments inside that file on how to do that. If you don't want to change the class comments for all your projects then you can place that files into your project directory (that way it will be used for your project) or inside the folder of your source files (that way it will be used only for the files inside that specific folder).

The last few tags should be self-explanatory. Under the line '\version' I usually insert short descriptions of what changed between versions.

Build Solution stats

This is a simple line counter. It counts all the lines of all files in your solution, grouped by projects. The generated html file with the counted lines (code, comments, empty) is then opened in the IDE. Since I haven't found a way to add a file directly to a solution and not to a project the file is just opened for view in the IDE.

Dependency and Inheritance graph

These two commands build graphs of the class relations in your solution. See my previous article about this. The difference to my old tool is that it now generates graphs for all projects in the solution and puts all the graphs in one single html page.

Swap .h<->.cpp

This is something a simple macro could also do: it swaps between header and code files. For better accessibility it also is on the right click menu of the code editor. Really nothing special but it can be useful sometimes.

Colorize

This tool goes through all files of the current solution and looks for class, function and macronames. It then writes them to a usertype.dat file, makes the IDE to read that file and deletes it again. After you run this tool, all class, function and macronames of your solution appear colored in the code editor. Default color is the same color as normal keywords, but you can change that under Tools->Options, in the Options dialog select Environment->Fonts and Colors.

If you don't want the colors anymore, just run the command 'disable coloring' and everything will be in normal colors again. I didn't want to overwrite some possible usertype.dat file already created by some user so the tool simply creates a temporary usertype.dat file instead. If you want to have the colors again the next time the IDE starts, you either have to rerun the command (doesn't take very long to execute) or change the code of the tool yourself.

} End of

Have you ever wrote a bunch of code which looked like this:

Braces without comments

Ok, I admit this isn't a very good style of programming, but sometimes it can't be avoided. And in those cases the code is horrible to read because you don't know which closing brace belongs to which opening statement without scrolling or using the macro 'Edit.GotoBrace' several times. This tool provides a function which inserts comments after the closing brace automatically. The code snippet above would look like this:

Braces with comments

Comments are only inserted for closing braces of if, while, for and switch statements.

If you don't want to insert comments automatically while editing, you can turn off this function. If you just don't want those comments at specific places you have to move the caret either upwards (instead of downwards which happens if you press enter) or click with the mouse so that the caret doesn't go to the line below the closing brace. Comments are also not inserted when the opening brace is less than two lines above.

#region/#endregion for C++

VS.NET introduced to possibility to outline portions of text in the code editor. That's a very useful feature wthat helps navigating through big bunches of code. But the outlined sections are not saved between sessions. VB and C# provide keywords to outline sections. In VB its '#Region' and '#End Region', in C# its '#region' and '#endregion'. Only for C++ MS didn't provide such keywords (at least I haven't found them yet). With this tool you can now enable that feature for C++ too. To prevent compiler errors for those who have not installed this tool I used '//#region' and '//#endregion' as the keywords. With the comment lines before the compiler won't complain. Use those keywords like this:

outlined sections

Whenever you open a document with such keywords the tool will automatically create outlining sections. The section are also created when you type the '//#endregion' keyword and a matching '//#region' is found. As you can see, you can easily nest the sections. The code above would then look like this:

outlined sections

outlined sections

This function can't be deactivated. If you don't want it, simply don't use those keywords :)

Search the web

These two small addons perform a simple web site search either in the google groups or on CP. Select a piece of text in the code editor, right click to pop up the menu and then select where to search for the selected text. That's all. The search results will be opened inside VS.NET.

right click menu

Install

To install the tools, just double-click the *.msi file and follow the instructions. If the tools are not automatically activated the next time you start the IDE, then please activate them under Tools->Add-In Manager. Make sure you select both the addin and the box 'startup'.

All additional files needed for the tools are also packed in the installer, including Doxygen and the dot files. So you don't have to grab them separately from the web.

Source

Full source code is provided with these tools. The addin is written in VB.NET cause first there was just one simple tool that I wanted immediately - and VB is good enough for that. Then the tool grew and I added more functions. So the code is surely not the best example for good programming (no plan, no structure -> chaos). But maybe it might still be of interest for those who want to write their own addins. It shows a way to create submenus and how to add a toolbar.

Revision History

24.06.03
  • fixed bug in Doxygen part: the path to the binaries weren't enclosed in ""
  • made necessary changes to make the addin work with VS.NET2003 (projectitems are now recursive!)
  • updated the Doxygen binaries to the newest version
  • the dialogs are now centered to the IDE
18.04.03
  • fixed some bugs in the }EndOf function
  • added template files for doxygen comments
  • fixed bug in the graph functions if the solution contained "misc" files
  • Doxygen 1.3 is now included
  • removed the toolbar - it slowed the editor down
  • for most commands disabled the check for project type (C++, C#, VB, ...) - if you use a function for a project type for what it isn't designed it just won't work...
04.10.02
  • enabled }EndOf and the solution statistics also for C# projects
21.9.02
  • fixed a bug in the }EndOf tool
  • fixed bug where Doxygen couldn't be started when a file was in the Solution->Misc folder
  • added possibility to run Doxygen for single projects (right click menu in solution explorer)
  • included newest Doxygen and Dot version
  • added a proper uninstaller. The uninstaller now deletes all added commands.
7.9.02
  • fixed a bug reported by Darren Schroeder
8.8.02
  • removed forgotten test code which caused annoying behaviour
  • made sure that for WinHelp output (Doxygen) also html output is selected
10.8.02
  • fixed a bug reported by Jeff Combs: now the addin is only loaded when the IDE is started (the IDE is NOT started when devenv is called with /build, /clean or /deploy command line switches!)
12.8.02
  • Run Doxygen now includes not only project directories but all directories of the project files.
  • The Toolbar can now be altered and the altered state is saved by the IDE
  • Uninstalling now works better: the toolbar is gone after the second start of the IDE after uninstalling without modifying the source.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
Software Developer
Switzerland Switzerland
---

Comments and Discussions

 
GeneralRe: Doesn't work with Beta 2? Pin
Anonymous28-Aug-02 12:13
Anonymous28-Aug-02 12:13 
General"About CommandBar in VS.net Pin
Feng Qin27-Aug-02 1:19
Feng Qin27-Aug-02 1:19 
GeneralRe: "About CommandBar in VS.net Pin
SteveKing28-Aug-02 6:25
SteveKing28-Aug-02 6:25 
GeneralNo output Pin
Anonymous21-Aug-02 23:57
Anonymous21-Aug-02 23:57 
GeneralRe: No output Pin
Anonymous22-Aug-02 5:29
Anonymous22-Aug-02 5:29 
GeneralRe: No output Pin
Anonymous22-Aug-02 5:42
Anonymous22-Aug-02 5:42 
GeneralRe: No output Pin
SteveKing22-Aug-02 6:19
SteveKing22-Aug-02 6:19 
GeneralRe: No output Pin
Anonymous27-Sep-02 5:03
Anonymous27-Sep-02 5:03 
I had exactly the same problem - seems it was related to either the .suo or .ncb file (intermediate files that live in the same directory as your .sln file). Closed down .NET, deleted all .suo & .ncb files in sight, re-ran and the generate doxygen button started working! Big Grin | :-D

Neat tool, thanks!
GeneralRe: No output Pin
SteveKing27-Sep-02 5:18
SteveKing27-Sep-02 5:18 
GeneralQuestion about CommandBar Pin
Feng Qin12-Aug-02 20:12
Feng Qin12-Aug-02 20:12 
GeneralGood Artical Pin
Brian Delahunty12-Aug-02 4:58
Brian Delahunty12-Aug-02 4:58 
GeneralToolbar modifications Pin
anonymouse11-Aug-02 2:45
anonymouse11-Aug-02 2:45 
GeneralRe: Toolbar modifications Pin
SteveKing11-Aug-02 5:01
SteveKing11-Aug-02 5:01 
GeneralRe: Toolbar modifications Pin
Anonymous11-Aug-02 17:33
Anonymous11-Aug-02 17:33 
GeneralRe: Toolbar modifications Pin
SteveKing11-Aug-02 20:49
SteveKing11-Aug-02 20:49 
GeneralError running devenv from cmd line Pin
Jeff Combs9-Aug-02 11:07
Jeff Combs9-Aug-02 11:07 
GeneralRe: Error running devenv from cmd line Pin
SteveKing10-Aug-02 0:22
SteveKing10-Aug-02 0:22 
GeneralBug fixed Pin
SteveKing10-Aug-02 0:53
SteveKing10-Aug-02 0:53 
GeneralBetter outlining w/o //#region Pin
Brandon Sneed8-Aug-02 3:43
Brandon Sneed8-Aug-02 3:43 
GeneralRe: Better outlining w/o //#region Pin
SteveKing8-Aug-02 5:51
SteveKing8-Aug-02 5:51 
GeneralRe: Better outlining w/o //#region Pin
Brandon Sneed9-Aug-02 5:06
Brandon Sneed9-Aug-02 5:06 
GeneralTotally awesome! Pin
pankajdaga8-Aug-02 3:33
pankajdaga8-Aug-02 3:33 
GeneralRe: Totally awesome! Pin
SteveKing8-Aug-02 4:20
SteveKing8-Aug-02 4:20 
QuestionQuestion about your resource project? Pin
Feng Qin7-Aug-02 22:46
Feng Qin7-Aug-02 22:46 
AnswerRe: Question about your resource project? Pin
SteveKing7-Aug-02 23:15
SteveKing7-Aug-02 23:15 

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.