Testing window-level Help without applications

You can use BugHunter to find out if your window-level Help topics are using the correct map numbers, even if the application is not available. The window-level Help topics you test must be compiled into a Microsoft HTML Help file (.CHM).

Before you start, print a copy of the Map IDs report. Use this report as a check list for testing each window-level Help topic. It provides you with a list of all topic IDs in your project. Grouped with each topic ID is its map number, the name of the map file that uses it, and the name of the window-level Help topic (.HTM file).

To test window-level Help:

  1. Compile your HTML Help project so all window-level Help topics and their aliases are included in the .CHM file.

  2. Right-click inside the BugHunter window and select Test HtmlHelp API.

  3. Select the compiled HTML Help file (.CHM).

    Click to locate the drive/folder where the .CHM file is located and double-click to select it.

  4. From Command, select HH_HELP_CONTEXT. This is the HtmlHelp API command that BugHunter uses to capture information about window-level topics.

  5. In Window, enter the name of the custom window you designed for your window-level Help topics. (The developer needs to program the application to use this window.) BugHunter will display the topics in this window as you test each one.

    Skip this step if you did not design a custom window. BugHunter will use the default window to display the topics.

  6. In Map Number, enter the map number to test. The Map IDs report shows which map number is used with each window-level topic. Use this for quick reference.

  7. Click Test.

 

Tips:

  • The Duplicate Map IDs report can Help you debug problems if the same map number is used with more than one topic.

  • BugHunter adds information about each topic you test and keeps it in the pane until you clear it.

  • Copy or save the information that BugHunter captures and use it to verify that you tested each window-level topic.

  • Customize the way information is displayed in the BugHunter pane to suit your preferences.

  • If the window-level topic is not displayed or the wrong topic is displayed, right-click the map number and update the alias to quickly fix the problem. You'll need to compile the project to retest the topic.