Click here to Skip to main content
Click here to Skip to main content
Go to top

Toolbar Editor for Visual Studio

, 31 Oct 2012
Rate this:
Please Sign up or sign in to vote.
A toolbar editor for Visual Studio. It can modify, add and create buttons, images and all that is needed for a toolbar.

Introduction

I usually spend a lot of time to give my projects a nice and user friendly GUI. In my opinion, in all desktop projects, it's "almost" mandatory to give the user something that can speed-up functions that are frequently used. The simpler (and most commonly used) method is to build a toolbar. Visual Studio comes with a toolbar editor but, really, I hate it; it's still limited to 16 colors, it can't load external images, and every time you want to add a new button, it is a pain. For all these reasons, I wrote my own toolbar editor for the Visual Studio IDE.

Installation

Simply run the setup, and follow the on-screen instructions (nothing more than the usual: next, next, yes, yes, next, finish). The setup utility of Toolbar Editor (TE) will also create two subdirectories: temp and imgLib. You can put all icons / images that you frequently use to build your toolbars in the imgLib directory: they will be displayed and previewed in TE so you can easily drop them in the toolbar on which you are currently working on. The default location of the two folder is:
[USERAPPDATA]\tbeditor 
(that in a standard Windows 7 installation is something like: C:\Users\username\AppData\Roaming\tbeditor)
In any case the location of these folders can be easly  customized by the dedicated option in the options dialogbox. 
To manage correctly the toolbar buttons ID, you should also specify where to found the afxres.h file. Toolbar Editor, starting from the 1.6 version, will try to found it by itself but, in the case it fails, you should select it manually. Please see the "Limitation of the toolbar editor" section for more information about this topic. 

How it Works

You can start to edit toolbars in a very few steps:

  • Open the resource file (.rc) of the project that you want to edit (or create a new toolbar)
  • Select the resource ID from the combo box.
  • Click on "Scan" button to get the preview of the currently loaded toolbar.
  • Edit the toolbar 
  • Merge the modification to the resource file using the “SAVE TOOLBAR” button 

 

Now you can add new buttons, move around the existing ones, and so on. Both the toolbar and the listbox used for preview supports drag & drop, so you can easily move buttons using your mouse. On the right side of the dialog window, there is a listbox that you can use as a library; it reads all supported types of images from a folder (remember that,if you want, you can change it in the Options Dialog) so you can take them and drop on the toolbar (you can also drop new images from the Explorer window). If the image loaded is too big (or too small), you can use the Resize function from the main menu.

When your toolbar is ready, you can click on the "SAVE TOOLBAR" button to merge it with your project: all needed IDs will be created and added to the resource.h file. If you don't want to modify your project files, you can disable this feature, and the new files will only be created in the temp folder of the editor. By default, the bitmap generated has a 4 bit color depth (16 colors) to maintain the preview active in the Visual Studio editor also, but it's possible to create grayed, true color, and "hot" bitmaps.


The bitmaps will be created in the ./res folder of the currently open project. By default, their names are the same as the toolbar's bitmap, with the _TC, _HT, and _GR suffix, but you can change both the destination folder and the name. You can add these bitmaps to your project, and then use them with some true color toolbar class like Dany Cantin's CTrueColorToolbar.

Let's say that YOUR_BITMAP_TC, YOUR_BITMAP_HT, and YOUR_BITMAP_GR are the IDs of these bitmaps, then you can use them in your OnCreate like:

m_ToolBar.LoadTrueColorToolBar(
        16,
        YOUR_BITMAP_TC,
        YOUR_BITMAP_HT, 
        YOUR_BITMAP_GR);

You should always create the true color bitmap because when you will open the toolbar again for editing, it will be used to create the imagelist instead of the 16 color version. Note that this will work only if the true color bitmap is saved using the default name bitmap_name_TC.bmp.

Finally, if you need only the imagelist, you can save it using the Save button in the bitmap section. This won't update .rc or resource.h in your project.

Creating New Toolbars

Even if you are creating a new toolbar, you need a resource file to put it in. For this reason, remember to open the right resource file before starting to work on the new toolbar. After you select "New" on the "File" menu (or you click on the "New" button in the main TE toolbar), the Toolbar Editor will ask for essential info about the toolbar: ID, size, and type (Visual C++ 20XX or Visual C++ 6).


The toolbar ID can also be a new one (not previously defined in your resource.h) but be careful: TE won't check if what you typed is a valid ID name, so avoid spaces, special chars, and so on...). After this point, you can work as previously described and, when you are ready, merge the toolbar with the "Generate" button, or copy the toolbar code to the clipboard using the menu entry Tools->Toolbar->Copy to clipboard.

Points of Interest 

Well, first of all, I hope that this tool is really useful for someone else other than me. You can also find a custom implementation of a drag and drop enabled toolbar (it works without the Shift button pressed).

Limitations of the Toolbar Editor

There are some considerations about IDs. My editor reads the toolbar structure from the .rc file, and the IDs defined in your project in the resource.h file: it doesn't know anything about any ID defined in other files. So be careful when you edit IDs in the Toolbar editor: if you use an ID already defined somewhere else than resource.h, it can be a problem during compilation.
As a backup solution consider that TbEditor can read IDs defined in other files just adding them in the file list available in the option dialog box. 


Just a note: The setup package doesn't come with afxres.h because I don't know if that file is copyrighted by Microsoft and/or if it's redistributable. A function to automatically found this file in your system is available and used by TBEditor but please consider that is not 100% accurate.
To put in your .rc file the new toolbars, TE uses as marker, this text: // Toolbar. If TE can't find the marker in your file, the merging of new toolbars will fail (note that this is a problem only for new toolbars).

Guidelines to Compile Toolbar Editor

Toolbar editor need Davide Pizzolato's CxImage class to compile.
This class is used to build, change resolution, color depth, etc. of bitmaps.
The tbeditor solution it's configured to look for CxImage in the same directory where you put the tbeditor folder. In other words, your directory structure should be something similar to:

main folder 
| 
|-- tbeditor source directory 
|-- CxImage 
|-- jpeg 
|-- j2k 
|-- jbig 
|-- jasper 
|-- tiff 
|-- png 
|-- zlib

where j2k, jpeg, jbig, etc. are all folders that came in the same archive of CxImage.
The latest sources version can always be found on the sourceforge repository

Credits 

My work was inspired by Tomkat'ss [^] great tool (Super ImageList and ToolBar generator [^]) that helped me a lot in the imagelist creation before I developed my own tool. I wish to also thank:

History

  • 1.0 - (2005/08/02)
    • First public release
  • 1.1 - (2005/08/03)
    • Fixed some compatibility issues with VC6
  • 1.2 - (2005/08/05)
    • Now it's possible to parse more files with IDs
    • Linked statically to avoid dependency problems
    • Changed true color bitmap generation checkbox to true as default
    • Now, if available, a true color bitmap is used to create the imagelist when a toolbar is opened
    • Disabled "error diffusion" in 16 color bitmap creation
  • 1.3 - (2005/09/12)
    • Added "new" toolbar feature
    • Added hot imagelist creation
    • Added some accelerators
    • Added MRU list
    • Improved drag and drop (now you can use it to move buttons also, and replace only the image by holding the CTRL key)
    • Fixed bug when two buttons have the same ID
  • 1.3b - (2005/10/27)
    • Added check for update routine
    • Fixed bug caused by MRU implementation (crash on startup)
    • Fixed bug with 16 colors bitmap (ugly view in preview)
  • 1.3c - (2005/11/06)
    • Some internal modification on code to prepare the new release
    • Fixed bug on "check for updates routine"
  • 1.3d - (2006/07/04)
    • Some internal modification on code to prepare the new release (again)
    • Better error handling during parsing
    • Minor bug-fix
  • 1.41 - (2008/01/05) **SHIPON**
    • New dialog Layout to handle toolbars up to 48x48px
    • Better icon handling: now before use they are all ported to true color
    • Added support for png images/icons
    • Fixed bug on reopening an existing toolbar without a true color bitmap
    • Fixed bug on first toolbar display: listcontrol without icon preview
    • Minor bug fixes
  • 1.42 - (2009/03/31) **SHIPON**
    • New function to select transparent color
    • Fixed bug that cause wrong background color selection
    • Fixed crash if wrong toolbar id is selected for parsing
  • 1.50 - (2011/07/09) **P.WIP**
    • Program default data directory moved to [USERAPPDATA] windows default folder. This is to avoid administrative user rights requirement in Vista/Windows 7.
    • Added a more detailed manual to the installation package
    • Moved to shared MFC linking to reduce EXE file dimension
    • Fixed bug on the new function to select the background color
    • Fixed bug on first toolbar display: listcontrol without icon preview
    • Minor bug fixes   
  • 1.60 - (2012/10/19). ***** FIREWORKS ****
    • Improvements
    • Imagelist editing
    • Rotate image: now the rotate image function is enabled
    • Resize image now use a better resizing algorithm
    • Export image to library function
    • Some improvements in the option dialog: “autodetect” feature of afxres.h file (works with visual studio 2005 up to 2010)
    • the background color is now prevented to be changed by the optimization of the palette when a bitmap < 24 bit is saved (16 color bitmap for example)
    • Better toolbar layout and document handling
    • Support for UNICODE files
    • Some UI improvements
    • BugFix
    • Fixed a bug during saving of gray scale bitmaps (bitmap file wrongly reported as 4bit depth)
    • Fixed some bad behaviors of menu
    • Minor bug fixes

Additional License Note

This program is free and provided "as is" without any expressed or implied warranty. Use at your own risk!

License

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

Share

About the Author

Francesco Aruta
Engineer
Italy Italy
No Biography provided

Comments and Discussions

 
QuestionI can not understand the sense of the program PinmemberMember 1097806529-Jul-14 3:19 
QuestionOpening 16x16 BMP file PinmemberGil Goodridge31-Jan-14 3:58 
AnswerRe: Opening 16x16 BMP file PinprofessionalFrancesco Aruta20-May-14 11:03 
QuestionI can not download file TBar_gifs16.zip Pinmemberipadilla25-Oct-12 1:29 
AnswerRe: I can not download file TBar_gifs16.zip PinmemberFrancesco Aruta30-Oct-12 23:57 
AnswerRe: I can not download file TBar_gifs16.zip PinmemberSteve Mayfield31-Oct-12 6:34 
GeneralMy vote of 5 PinmemberMarco Bertschi22-Oct-12 6:28 
GeneralRe: My vote of 5 PinmemberFrancesco Aruta22-Oct-12 6:57 
BugVer 1.5 not reading any ID PinmemberPierre Filion1-Oct-12 12:49 
GeneralRe: Ver 1.5 not reading any ID PinmemberFrancesco Aruta2-Oct-12 6:11 
GeneralRe: Ver 1.5 not reading any ID PinmemberPierre Filion2-Oct-12 9:12 
GeneralRe: Ver 1.5 not reading any ID PinmemberFrancesco Aruta5-Oct-12 22:53 
GeneralRe: Ver 1.5 not reading any ID PinmemberFrancesco Aruta10-Oct-12 22:14 
GeneralRe: Ver 1.5 not reading any ID PinmemberPierre Filion17-Oct-12 3:46 
GeneralVersion 1.60 released! PinmemberFrancesco Aruta19-Oct-12 5:45 
GeneralMy vote of 5 Pinmembermaplewang16-Jul-12 22:01 
QuestionExcellent Pinmember=[ Abin ]=20-Oct-11 20:52 
QuestionNot working for 32x32 image Pinmembersally899818-Aug-11 14:38 
AnswerRe: Not working for 32x32 image PinmemberFrancesco Aruta30-Aug-11 2:12 
QuestionToolbar Editor 1.42 PinmemberK. H. Renders14-Dec-10 21:31 
GeneralProblems with 4.1 PinmemberHugh S. Myers5-Jul-08 7:19 
Question"New version available" PinmemberT800G29-Nov-07 14:35 
GeneralRe: "New version available" PinmemberFrancesco Aruta6-Dec-07 6:57 
NewsNew version available PinmemberFrancesco Aruta10-Jan-07 2:12 
GeneralWon't always generate 24 bit bitmaps &amp; other issues Pinmemberroel_14-Nov-06 1:27 
GeneralRe: Won't always generate 24 bit bitmaps &amp; other issues PinmemberFrancesco Aruta14-Nov-06 9:46 
GeneralRe: Won't always generate 24 bit bitmaps &amp; other issues Pinmemberroel_14-Nov-06 22:49 
GeneralRe: Won't always generate 24 bit bitmaps &amp; other issues PinmemberFrancesco Aruta18-Nov-06 1:34 
JokeNew version available! PinmemberFrancesco Aruta4-Jul-06 0:01 
GeneralWon't read our. rc file Pinmemberloopless26-Apr-06 13:48 
GeneralRe: Won't read our. rc file PinmemberFrancesco Aruta27-Apr-06 20:12 
GeneralRe: Won't read our. rc file Pinmemberloopless28-Apr-06 4:06 
GeneralRe: Won't read our. rc file PinmemberFrancesco Aruta29-Apr-06 13:08 
GeneralTruly Transparent Toolbar Pinmemberjonnospam7-Mar-06 4:11 
GeneralRe: Truly Transparent Toolbar PinmemberFrancesco Aruta7-Mar-06 8:31 
GeneralHeight of toolbar Pinmembernetikus5-Dec-05 13:18 
GeneralRe: Height of toolbar Pinmembernetikus5-Dec-05 15:01 
GeneralRe: Height of toolbar PinmemberFrancesco Aruta5-Dec-05 23:00 
NewsNew version available! PinmemberFrancesco Aruta27-Oct-05 4:17 
Generalquestion Pinmembershuzhonglin18-Oct-05 5:30 
GeneralRe: question PinmemberFrancesco Aruta18-Oct-05 12:43 
QuestionRe: question Pinmembershuzhonglin18-Oct-05 16:06 
AnswerRe: question PinmemberFrancesco Aruta19-Oct-05 1:16 
AnswerRe: question Pinmembershuzhonglin19-Oct-05 4:24 
GeneralRe: question PinmemberFrancesco Aruta19-Oct-05 6:55 
GeneralRe: question PinmemberFrancesco Aruta20-Oct-05 23:28 
QuestionThis is the first time ... PinmemberWalter Eckel27-Sep-05 1:36 
AnswerRe: This is the first time ... PinmemberFrancesco Aruta6-Oct-05 12:08 
General32x32 icons PinmemberAtlence21-Sep-05 12:25 
GeneralRe: 32x32 icons PinmemberFrancesco Aruta21-Sep-05 22:57 

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.140916.1 | Last Updated 31 Oct 2012
Article Copyright 2005 by Francesco Aruta
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid