18.4.2 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.6
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.1 Using CSS
and font tags with HTML Help
Next Topic: 18.4.3 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.3 Adding expandable
sections to HTML Help