show toc sync toc index
Adding Menu Items Customizing the Browser T... Browser Extensions Tutori...
Web Workshop | Reusing Browser Technology
Adding Toolbar Buttons--------------------------------------------------------------------------------This tutorial explains how to add a toolbar button to the Microsoft® Internet Explorer user interface. The toolbar button can either run a Win32® application, run a script, or open an Explorer Bar. If you also want to create a menu item for the Win32 application or script, see the Adding Menu Items tutorial.Note By default, custom toolbar buttons do not appear on the Internet Explorer toolbar. These buttons will appear in the left side of the Customize Toolbar dialog box.Requirements and Dependencies
General Steps
Adding the Details
Related Topics
Requirements and Dependencies
Developers who want to add toolbar buttons to Internet Explorer must be familiar with the registry and globally unique identifiers (GUID).This feature is only available in Internet Explorer 5 and later. Internet Explorer 4.0 allows you to add a custom Explorer Bar, but there is no method for adding a toolbar button to access your Explorer Bar.Toolbar buttons require two sets of icons: one set with the active (color) icons and one set with the default (grayscale) icons. These icons can be stored in two .ico files or inside a resource (like a .dll or .exe file). For more information about what icons are required and for tips on designing icons for Internet Explorer, see Toolbar Button Style Guide.General Steps
The steps in this section must be followed when adding any toolbar buttons to the Internet Explorer user interface. If any information is omitted, the toolbar button will not be displayed.Icons and strings stored inside a resource can be referenced by providing the path to the resource and reference identification in the format, "path; resource_id". For example, if you wanted to use string resource 123 in Example.dll, you would use "Example.dll, 123".Note This tutorial describes how to add a toolbar button for all users. If you want the toolbar button displayed for the current user only, substitute HKEY_CURRENT_USER for HKEY_LOCAL_MACHINE in the steps below.Create a valid globally unique identifier (GUID). You can use Guidgen.exe (which ships with Microsoft® Visual Studio®) or Uuidgen.exe (which ships in the Microsoft® Platform Software Development Kit(SDK). ).
Create a new key (with the GUID as the name) in the registry under:
HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\ExtensionsThe result should look like:HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID><Your GUID> is the valid GUID that you created in step 1.Optional. Create a new string value, Default Visible, in the registry under:
HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>The result should look like:HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>\Default VisibleTo make the toolbar button to appear on the Internet Explorer toolbar by default, set Default Visible to "Yes", otherwise set Default Visible to "No".Note If the user has customized the toolbar, the button will not appear on the toolbar automatically. The toolbar button will be added to the choices in the Customize Toolbar dialog box and will appear if the toolbar is reset.Create a new string value, ButtonText, in the registry under:
HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>The result should look like:HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>\ButtonTextSet the value of ButtonText to the label you want for the toolbar button.Create a new string value, HotIcon, in the registry under:
HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>The result should look like:HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>\HotIconSet the value of HotIcon to the full path of the .ico file that contains the three color icons.Create a new string value, Icon, in the registry under:
HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>The result should look like:HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>\IconSet the value of Icon to the full path of the .ico file that contains the three grayscale icons.Optional. Provide support for multiple native languages (like French or Japanese).
Complete the following steps to support different native languages:Determine the LCID of the native language you want to support. These values can be found in the Microsoft® Platform Software Development Kit(SDK).
Create a new key, Lang####, using the LCID from the previous step in place of "####" in the registry under;
HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>The result should look like:HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>\Lang####For example, the key name should be Lang0411 for a Japanese implementation, since the LCID for Japanese is 0411.Adding the Details
After completing the initial step of creating a new registry key, you will add values under the key. The values that you will need and the other steps to follow depend on what the toolbar button is going to run. The following list contains links to the sections with the steps required to complete the addition of a toolbar button.COM Objects
Explorer Bars
Scripts
Executable Files
COM Objects
The following steps are required to complete the creation of a toolbar button that implements a COM object. If any information (that isn't optional) is omitted, the toolbar button will not be displayed.Note This tutorial describes how to add a toolbar button for all users. If you want the toolbar button displayed for the current user only, substitute HKEY_CURRENT_USER for HKEY_LOCAL_MACHINE in the steps below.Register the COM object.
Create a new string value, CLSID, in the registry under:
HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>The result should look like:HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>\CLSIDSet the value of CLSID equal to {1FBA04EE-3024-11d2-8F1F-0000F87ABD16}.Create a new string value, ClsidExtension, in the registry under:
HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>The result should look like:HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>\ClsidExtensionSet the value of ClsidExtension equal to the GUID of the COM object.In addition to the previous steps, the COM object must implement IOleCommandTarget.If your COM object needs to access the DHTML Object Model of the page that Internet Explorer is currently displaying, you must implement IObjectWithSite.
The implementations of IOleCommandTarget's methods are standard, except for IOleCommandTarget::Exec. The COM object's IOleCommandTarget::Exec method is called with nCmdID=1 if the toolbar button is clicked and nCmdID=2 if the menu item is clicked. This difference allows developers to provide different behaviors for the toolbar button and the menu item.When IObjectWithSite is implemented, Internet Explorer will call IObjectWithSite::SetSite and pass it a pointer to IShellBrowser.Explorer Bars
The following steps are required to complete the creation of a toolbar button that opens an Explorer Bar. If any information (that isn't optional) is omitted, the toolbar button will not be displayed.Note This tutorial describes how to add a toolbar button for all users. If you want the toolbar button displayed for the current user only, substitute HKEY_CURRENT_USER for HKEY_LOCAL_MACHINE in the steps below.Create a new string value, CLSID, in the registry under:
HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>The result should look like:HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>\CLSIDSet the value of CLSID equal to {E0DD6CAB-2D10-11D2-8F1A-0000F87ABD16}.Create a new string value, BandCLSID, in the registry under:
HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>The result should look like:HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>\BandCLSIDSet the value of BandCLSID to the CLSID of the Explorer Bar you want to open.Note All Explorer Bars have a menu item added to the View menu automatically.Scripts
The following steps are required to complete the creation of a toolbar button that runs a script. If any information (that isn't optional) is omitted, the toolbar button will not be displayed.Note This tutorial describes how to add a toolbar button for all users. If you want the toolbar button displayed for the current user only, substitute HKEY_CURRENT_USER for HKEY_LOCAL_MACHINE in the steps below.Create a new string value, CLSID, in the registry under:
HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>The result should look like:HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>\CLSIDSet the value of CLSID equal to {1FBA04EE-3024-11D2-8F1F-0000F87ABD16}.Create a new string value, Script, in the registry under:
HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>The result should look like:HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>\ScriptSet the value of Script to the full path of the script that will be run.To add a menu item in the Tools menu with the same functionality, see Scripts in the Adding Menu Items tutorial.Executable Files
The following steps are required to complete the creation of a toolbar button that runs an .exe file. If any information (that isn't optional) is omitted, the toolbar button will not be displayed.Note This tutorial describes how to add a toolbar button for all users. If you want the toolbar button displayed for the current user only, substitute HKEY_CURRENT_USER for HKEY_LOCAL_MACHINE in the steps below.Create a new string value, CLSID, in the registry under:
HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>The result should look like:HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>\CLSIDSet the value of CLSID equal to {1FBA04EE-3024-11D2-8F1F-0000F87ABD16}.Create a new string value, Exec, in the registry under:
HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>The result should look like:HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\<Your GUID>\ExecSet the value of Exec to the full path of the .exe file that will be run.To add an item to the Tools menu with the same functionality, see Executable Files in the Adding Menu Items tutorial.Related Topics
The following lists contain links to topics related to adding toolbar buttons.OverviewsBrowser Extensions Overview
Toolbar Button Style Guide
Web Accessories Overview
TutorialsAdding Menu Items
Back to top
Did you find this topic useful? Suggestions for other topics? Write us!
Active Server Pages error 'ASP 0113' Script timed out /workshop/browser/ext/tutorials/button.asp The maximum amount of time for a script to execute was exceeded. You can change this limit by specifying a new value for the property Server.ScriptTimeout or by changing the value in the IIS administration tools.
http://www.intelligo.net/iedelphi/index.html