CodeProject: Creating DeskBands with an ATL Object Wizard. Free source code and programming help

Report Article

Discuss

Send to a friend

51 votes for this Article.

Popularity: 7.41 Rating: 4.34 out of 5

Download Source Files - 32.3 Kb

Sample Image - RBDeskBand.gif

What Are DeskBands?

There are 4 types of deskbands. A Communications Band which sits at the bottom of an instance of IE4+. An Information Band sits on the left hand side of an instance of IE4+, like the search bar that allows you to search for files or folders on a hard drive. A Desk Band sits on the desktop, it can float or dock to any of the 4 sides of your monitor. The final type is a Toolbar which sits in the rebar space of Internet Explorer, like the address bar.

To see this, start IE4+. Click the "View" menu item, go down to the "Explorer Bar" menu item. The top half above the seperator are the available Information Bands, the bottom half are the communication bands.

To see a deskband, right click on the taskbar (area connected to the start button). Select the toolbar's menu item from the context menu. listed are the available deskbands.

Deskbands can also reside as toolbars inside IE4+. The wizard does not currently provide this code although I do have it available. I will be updating the wizard in the next week or so to support toolbars and be more configurable.

Installation

In this version you no longer need the Microsoft Installer installed to be able to use this ATL Object Wizard. In the past the files were stored in an MSI file which would install the files to the correct location and allow for easy uninstalltion. To allow more people to use the Wizard. I have moved the files out of the MSI and leave it to the user to place them in the correct location using the instructions below.

Steps:

Extract the files from the source zip above to your Visual Studio location under the following relative path Common\MSDev98\Template\ATL.
Run the RegSvr32.exe from a command prompt on RBDeskband.dll. RegSvr32 RBDeskBand

Path Examples For Step 1:

C:\Program Files\Microsoft Visual Studio\Common\MSDev98\Template\ATL
C:\MyDevEnv\Common\MSDev98\Template\ATL

Usage

To create a DeskBand base implementation, do the following:

Start the ATL Object Wizard using the 'New ATL Object' option avalable from the Insert menu.
Select the "DeskBand" ATL Object Wizard component from the "RadBytes" category.
Fill in the Names Dialog page with your Deskband information.
Select the "DeskBand ATL Object Wizard" Tab.
Select at least one DeskBand type you want to expose your band as.
Click Ok
Your project will be updated with the associated class files needed to compile your base implemenation of a deskband.

I Ran The Wizard But Now What?

All that is required of you is to implement your content and inner workings for the band you created. A base window exists that is a static. This is there for easy pullout and inseration of any replacement code. I choose this instead of attaching a CWindowImpl directly to the deskband for ease of change, use, and adaptability.

My Deskband Is Not Listed In The Menu Items

Make sure that you are looking at the correct list of menu items for the type of band you created.

Also remember that the explorer.exe process caches the list of Explorer Bars and Toolbars on first access of the menu for the life of your Windows session, not IE session. So if you have accessed the menu during this session you will either need to log off and log back on or kill the explorer.exe process.

Auto Generated Code

The output created is a Source, Header, and Registry Resource files from the Short Name supplied in the ATL Object Wizard property page. The files that get modified by the wizard are: your main source, IDL, RC, and DSP files.

Unicode

The code generated will compile both under UNICODE and ANSI.

History

1.1
[March 22, 2001]

Fixes:

Band Registration problem, Threading model was set to Single [Hwan, Erik Funkenbusch]

Removed MSI requirment. [Siddhartha Ghosal]

Removed the Thank you dialog. I decided it was annoying and useless.

Additions:

Added new Wizard Page to allow creation of Band in multiple ways.

Added Internet Explorer toolbar support

Use ATL CATEGORY_MAP [Erik Funkenbusch]

Outstanding Issues:

Testing has shown that adding numerous Bands to a project using the Wizard causes VC to insert #include directives at the bottom of the project source file. No known fix and infrequent occurance.

Adding multiple Internet Explorer Toolbars to one project will cause redefinition of HKEY hKeyLocal = NULL;. Fix is to remove redundant definition.

Initial Release
[April 13, 2000] My first release of the ATL Object Wizard and article publishing.

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

About the Author

Erik Thompson

Sitebuilder

Erik lives in Redmond, Washington. He works as a Senior Software Engineer specializing in C++, COM, ATL and the middle-tier and now .NET. When he isn't coding for work, he can be found trying to extend Internet Explorer with yet another Desk band or simplifying his development process with ATL Object Wizards.

He spends his free time snowboarding, mountain biking, reading, dining out at those hidden finds.

Occupation:	Web Developer
Location:	United States

Other popular ATL articles:

Beginner's Tutorial: COM/ATL Simple Project
The purpose of this tutorial is to give you an idea on how to create a COM Server using ATL, and then being able to call the server from both a Visual C++ and Visual Basic program.
ATL Under the Hood - Part 1
In this series of tutorials I am going to discuss some of the inner workings of ATL and the techniques that ATL uses.
Using User Defined Types in COM & ATL
A Step by Step tutorial on SAFEARRAYs and UDTs in COM
ATL Grid control
A grid control for displaying tabular data, based on Chris Maunder's grid control
ATL Server - Web Application/Web Service
Web Application/Web Service development using ATL Server classes