HTML Help Viewer UI

<< Click to Display Table of Contents >>

Navigation:  Reference > Project Configuration Settings > Publishing Options > HTML Help > Help Windows >

HTML Help Viewer UI

These options control the appearance and behavior of the main HTML Help viewer (Main help window) and the viewer windows for external windows (user-defined secondary windows).

Specifying a secondary help window in a hyperlink to a topic will only have any effect in HTML Help if the option Links to secondary help windows open a new help window is activated here. If not, all the secondary window settings will be ignored and the settings for Main will be used.


prod_tip       Productivity Tip

Note that there is no Keep window on top setting for HTML Help. This can only be activated by the programmer in the call to the HTML Help see the HTML Help API documentation for details.


Links to secondary help windows open a new help window:

Activates external windows. When you specify a secondary help window in the Insert Hyperlink dialog (with the Window: option) the target window will be opened in an external window with the settings for the specified secondary window.

If this option is not activated links to secondary windows will open in the main help viewer.

Visible buttons:

These options are used to choose which control buttons are displayed in the help viewer. You may want to switch them all off for external windows.

Window has a navigation panel:

This option activates or deactivates display of the help viewer's navigation panel containing the Table of Contents, keyword index and other tabs. You may want to disable this for external windows. Note that if you also disable the Hide/Show button in the Visible Buttons section the user will not be able to activate the navigation panel at all!

Search tab:
Favorites tab:

These options activate or deactivate the display of the Search and Favorites tabs in the navigation panel. Note that if they are disabled it will not be possible for the user to enable them.

Save size and position in Registry:

When this is selected the current help window size and position are saved in the Windows Registry when the user closes the help. Otherwise the size and position you define will always be used. Don't turn this option off; it really annoys most users if their positions are not saved!

User-defined buttons:

Allows you to define two HTML URLs as targets for the Home button and two user-defined buttons. (These buttons must also be activated in Visible buttons: to be displayed.)

You cannot enter links to topics in the help here. Note that you must enter fully-qualified URLs including the protocol (i.e. http://, ftp:// etc). Simple URLs without the protocol (e.g. will  not work.

You can edit the names of the Jump 1 and Jump 2 buttons but you cannot change the name of the Home button.

The icons displayed for these buttons are hard-wired into the Microsoft HTML Help viewer and cannot be changed.

See also:

Secondary windows