This working example is based on the Toolbar for IE sample by Rashid Thadha. I tried to incorporate most features that are found in the Google toolbar (and some new ones). It looks much like the Google Bar now and now you can even customize it.
I am planning to list of support bug, features list at toolbar's homepage. Hope there will be more images, FAQs and knowledge bases.
- The ToolBar is fully customized from a xml file.
- No resource files are needed.
- Automatic update of toolbar and all media files.
- Automatic detection of changed files and download from web-server.
- Compiles, links and runs under VC.Net
- Multi-level menu
- TEXT tag - you can create an icon with a static text!
- The adding *many* COMBO BOXES
- PAGE tag - you can insert HTML page into toolbar.
- .CAB package. I demonstrate how to make an install package.
- POST request
- Include additional XML.
- Combo box has (history and autocomplete features) and you can define several different web engines.
- Buttons, large buttons (with different size images), separators, drop-down menus with images and hints for items.
- Tooltips for buttons.
- Drag-drop into search combo-box.
- Options, About page.
- Open local/web URL in a new/old/modal dialog window.
- Highlight words and an incremental find in a html page (like in the Google toolbar).
- Uninstall the ToolBar directly from the web browser.
- Run-time hiding, disabling of buttons, changing combo-box size and other options in options page (see options for details).
- Change image on mouse entering.
- Automatically open IE and visualize the toolbar during dll registration.
- Single / Split / None types for Buttons in the main menu.
- You can use current URL, domain, toolbar_id and some other in web url and posting data.
hot_img attribute in MENU tag - all icons can be changed on the mouse over event.
- Some commands are replaced with a new SPECIAL command type.
- The Combo box includes predefined values.
- Uninstall removes ALL Downloaded files.
- Added xmill support to compress XML files.
- Added icon into standard toolbar to show/hide your toolbar.
- Show/Hide toolbar from toolbar's menu.
- Make a Post request using InternetConnect, HttpOpenRequest and so on functions.
- TAB key can toogle between combo boxes.
- Disables mouse wheel into combo-boxes.
- Hot images can included into multi-level menus.
- Load xml and other images from resources.
- Load images from an external dll file.
- Choice of several different fonts.
- An update can be "run" from the setup program.
- You can use simple standard menu (without images).
- You can check if user changed local files on his computer.
- Change text colour into blue on over mouse event.
- Execute an external program.
- TAB now jump focus from Standart address bar to first combo box, next combo box,.., back to address bar. Shift key also works.
- Now you can insert not only combo boxes but also edit control. (see line 81 in BandEditCtrl.inl).
- Script tag - can execute java scripts!
- Source reorganized a little (as always) I tried to add more comments.
- You can add text into buttons with bitmaps (not icons)!
- Added sample Context menu handler in HTML page - select some text and right-click mouse in HTML to call popup menu.
- Now you can put several fonts in XML file and I'll find first installed on user's computer.
- Ticker control, comment are welcome.
- Lot of resource and memory leaks fixed.
- Show/hide mechanism : added parameter
vis_id - now you can hide each button and each MenuItem!!
- Fixed status bar hints in menus in Split menus with icon.
- Added encoding for search parameters
- Added update dll mechanism. see
UPDATE_DLL define for details.
- Added direct parameter to add search in list on options page (
addtoselect - set it to "yes").
- It was 1:00 a.m. and I decided to add small
TBInfo struct in this project. look on it - may be you don't know about that technique and you will like it
wordfindHint attribute - now you can see hints for "find" auto-generated buttons, too.
- Added new mechanism to monitoring connection to WWW, not finished yet.
- Removed Scope attribute from Setting - implemented using CHECKBOX now.
I am sure I forgot about some other features I implemented :( Have a look through source code to find some more... :)
To install the ToolBar: run "regsvr32.exe %path%\2Find.dll". It will check for the 2find.xml and some other files in the same directory. If they are not present there then it will try to download them from http://zmike.chat.ru/toolbar directory. If it can't be done it will display an "empty" toolbar in IE. In the new version you can open toolbar_sample.html in your IE and installation process will start automatically. Note: you can use WinZip to extract the .dll file from the .cab file.
You have to download and install Microsoft Platform SDK (at least Core SDK). Also check that you installed SP5 for Visual Studio. On NT4 ensure you have installed SP6a.
Add in the first include directory for Platform Sdk (something like "E:\Microsoft Platform SDK\Include" in VC++ -> Tools -> Options -> Directories -> Include files). For example:
To help you (if you don't want to download and install Platform SDK), I've put the necessary compressed includes from the Platform SDK here. Use the latest WinRar to extract them:
- unpack .rar to some folder
- then add it to VC headers directories (at the top of the list)
- rebuild project
Don't forget to include the WTL library (7.0). Check out NamesInc.cpp for some important constants.
I tried to help you (if you don't want to download and install Platform SDK) I've put the comppresed includes from Platform SDK here. Use the latest WinRar to extract them:
- unpack .rar to some folder
- then add it to VC headers directories (at the top of the list)
- rebuild project
Don't forget about the WTL library. See NamesInc.cpp for some important constants.
I'll describe here only the differences and new features that I added/changed. For more details see the Toolbar for IE sample by Rashid Thadha. To Implement the automatic detection of changed files and downloading them from web-server - feature and to prevent changing the toolbar on client side (disabled in this sample). I use the
GetCRC function to calculate the CRC of each local file, store it in the registry and if it is changed download the newer file from the web server. In the sample I have disabled this feature: uncomment
/*|| oldcrc!=newcrc*/ string to enable it.
You can even make .asp file on your web server and send a .xml file (with settings ) as output of it. Look at these lines:
if (sstrFile == _bstr_t(L"ecoach.xml"))
sstrFile = L"ecoach.asp";
Here is main code to open a new web browser to display and enable the toolbar.
HRESULT hr = CoCreateInstance(CLSID_InternetExplorer, NULL,
vtBandGUID.vt = VT_BSTR;
vtBandGUID.bstrVal = SysAllocString( pszBarCLSID );
vtShow.vt = VT_BOOL;
vtShow.boolVal = bShow;
vtNotUsed.vt = VT_INT;
vtNotUsed.intVal = 1;
HRESULT hr = pIE->ShowBrowserBar(&vtBandGUID, &vtShow,
Here is an example of how to register the
OnChange event handler in an opened page.
IHTMLElementPtr e3 = NULL;
IHTMLDocument2Ptr pHtmlDoc2 = pHtmlDoc3;
IHTMLSelectElement *e = NULL;
HRESULT hr= e3->QueryInterface( __uuidof( IHTMLSelectElement ),
V_VT(&vIn) = VT_DISPATCH;
V_DISPATCH(&vIn) = dispFO;
hr = e->put_onchange( vIn );
And here is the prototype for the handler:
void OnSelChange( DISPID id, VARIANT* pVarResult );
I use these functions to detect if any documents (for example the options page) have been loaded.
SINK_ENTRY_EX(0, DIID_DWebBrowserEvents2, DISPID_ONQUIT, OnQuit)
SINK_ENTRY_EX(0, DIID_DWebBrowserEvents2, DISPID_DOWNLOADCOMPLETE,
We can also modify the loaded page and/or add new elements:
hr = pHtmlDoc2->createElement(_bstr_t(L"OPTION"),&element);
IHTMLOptionElementPtroption = element;
hr = e->add(element,_variant_t(long(-1)));
or change old ones.
IHTMLInputElement *i = NULL;
HRESULT hr = el->QueryInterface( __uuidof( IHTMLInputElement),
I use this code to load the bitmaps from disk.
And this from the resources:
And this one to load from another .dll file:
h_image = LoadLibrary(filebmp.c_str());
Here is the appending owner-draw menu:
handle.AppendMenu(MF_OWNERDRAW,WM_MENU_USER + MAX_MENU_SIZE*id +j,
I added this handler to process the default function; you can find them in Platform SDK.
Expected multi-level menu !
<MENU> tag in "Menu" button and
virtual void appendMenu(CMenuHandle handle,...) functions
I demonstrate how to make an install packgage. Use CabArc.Exe, makecert.exe, exptext.exe, signcode.exe See toolbar_sample.bat and toolbar_sample.html for details.
See post attribute in
WEBJUMP atg and the most interesting
getPostData function that uses
Include additional XML.
in XML file
Single / Split / None types for Buttons in the main menu.
type attribute of
Menu tag see .XML for details
You can use current URL, domain, toolbar_id and some other in web url and posting data.
%url - current url
%d - domain
%nid - toolbar id
and some others - see sources for details
Some commands are replaced with a new
SPECIAL command type. Command types: ClearHistory, Search, Uninstall, Update, Switch to, Make Default Toolbar, Hide toolbar, and others see Special class and
SPECIAL tag for details
See toolbar_sample.html for details
Uninstall removes ALL Downloaded files.
I store them in HKEY_CURRENT_USER\Software\toolbar_sample\toolbar_sample\Historyfiles
and I delete .dll during Windows restart. I write a value into RunOnce key in registry.
Added xmill support to compress XML files.
I didn't add sources it in this sample but you can easy insert it. see
_XmlParserImpl::parse in XmlParserImpl.cpp
Added icon into standard toolbar to show/hide your toolbar.
_bstr_t ico = getprogpath() + "favicon.ico";
keyAppID.SetValue("yes", "Default Visible");
PAGE tag - you can insert HTML page into toolbar.
class CPage :
public IDispEventImpl<1, CPage, &DIID_DWebBrowserEvents2,
&LIBID_SHDocVw, 1, 0>,
...for details - it is very short.
Hot images into multi-level menu.
I chaged CCommandBarCtrlImpl::DrawItem3D function a little.
Load xml and images from resources.
load images from external dll file.
EnumResourceNames(h_image,RT_BITMAP,EnumResNameProc,0); and see details.
You can add several
<FONT> tags into XML.
- Update can be "run" from setup program Find
UPDATE_DLL_FROM_EXE for details.
- You can use simple standard menu (without images) Find
_USE_SIMPLE_MENU fro details.
- You can check that user changed local files on his computer Find
_DONT_CHECK_VERSION_FILE in sources.
- Make text blue on over mouse event: See
CBandToolBarReflectorCtrl::OnItemPrePaint for details.
- Execute an external program. Execute extern application see for example:
<SHELLEXECUTE name="Send mail"
not_found="Can't send email"/>
All other features and functions implemented looking in MSDN and codeproject site :-)
Auto Complete and Tooltips
Drag - drop in search combo-box
Change Image on Mouse Image Entering, All Buttons as Images
You can see xml source here
I am using my own XML parser helper to process it.
Note that there are NO scripts in options page. I use events to set/get settings. You can see the HTML text here
Adrian Bickle helped me in editing of this article. I am planning to add more details about implementation. But please tell me what items are more interesting for you.
Victor Chiel made a great index of Index of Bugs, fixes, request, isntalation problems
I am planing to support list of bug, features list at toolbar's homepage.
Hope there will be more images, FAQs and knowledge base.
So, you are welcome.
Thank you for your attention.
- v1.0.0 (13 March 2002) Initial release
- v1.0.4 (22 March 2002) Fixed problems with registration on Win98. Fixed some problems with IE in Offline mode.
- v1.0.5 (22 November 2002) A lot of features/bugs added/removed. Most important: VC.Net support, multi-level menus.
- v1.1.0 (1 February 2003) A lot of bugs added/removed.
- v1.2.0 (29 May 2003) Ticker control, Script command, context handler, some other cosmetic changes.