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
Table of Contents • Index