18.4.3 Adding tabs and toolbar
buttons to HTML Help
You can use HTML Help Workshop to enable additional
tabs and toolbar buttons for navigation and other features. For example,
rather than create links for Prev and Next, you can enable
built-in browse buttons for this purpose.
Note: Enabling browse buttons
requires a binary TOC, which can cause problems with mid-topic TOC links;
see §18.9.5
Providing mid-topic contents links in HTML Help. Also, a
binary TOC is not compatible with merged CHM files; see §18.14.5 Comparing
HHW settings for stand-alone vs. merged CHMs.
To enable additional HTML Help tabs and toolbar buttons:
- Set the following option in
your project configuration file, to avoid overwriting the changes you
are about to make to the HTML Help .hhp project file:
[MSHtmlHelpOptions]
WriteHelpProjectFile=No
See §18.3.8 Regenerating
the HTML Help project file
- In HTML Help Workshop, click
File > Open.
- In the Open dialog, type:
I'm MSDN
(straight single quote, not curly) and click Open.
- Select your .hhp project file.

Figure 18-1 HTML Help Workshop Project
tab
- On the Project tab toolbar,
click Add/Modify window definitions, as shown in Figure 18-1.
- If the Add a New Window Type
dialog opens, type main, and click OK;
the Window Types dialog opens, as shown in Figure 18-2.
- For window type choose (or specify)
main.
- To add a favorites tab to your
project, select the Navigation Pane tab and check Favorites
tab.
- To add toolbar buttons, select
the Buttons tab.

Figure 18-2 HTML Help Workshop Window
Types
- Check the button types you want
HTML Help to display in the toolbar. For example:
- Click OK.
- Click File > Save Project.
Browse buttons require
a binary TOC
To use Prev and Next browse buttons
in your help file, you must also compile a binary table of contents.
Under [Options] in the .hhp file, add the following
line:
Binary TOC=Yes
Or, you can set this option in HTML Help Workshop:
- Select the Project tab.
- On the Project tab toolbar,
click Change project options; the Options dialog opens.
- Select the Compiler tab.
- Check Create a binary TOC.
- Click OK.
- Click File > Save Project.
Previous Topic: 18.4.2 Eliminating
graphic and table indents from HTML Help
Next Topic: 18.4.4 Adding expandable
sections to HTML Help
Parent Topic: 18.4 Customizing HTML Help display features
Sibling Topics:
18.4.1 Using CSS and
font tags with HTML Help
18.4.2 Eliminating
graphic and table indents from HTML Help
18.4.4 Adding expandable
sections to HTML Help