Troubleshooting What's This? Help

Note: Before you test What's This? Help with BugHunter, right-click in the BugHunter pane and select Options from the menu. In Display options, clear Only Window-level Help messages (this option only captures calls made for window-level Help topics).

 

Symptom:

Topic is not displayed.

Error message:

1. No message

Cause of problem:

Author did not create a text-only topic (for a field or control in a dialog).

How to correct it:

Create a new text-only topic for the field or control in the dialog.

For developer-supplied map files, be sure to import the file first, and then create the text-only topics.

Compile the project and retest using the updated .CHM file.


Symptom:

The wrong What's This? Help topic is displayed about the field or control.

Error message:

Command: HH_TP_HELP_WM_HELP?HH_TP_HELP_CONTEXT_MENU

Processing Project_Name.chm

Control ID: 1174

Help ID: 1003

File: Folder_Name/FileName.TXT

Cause of problem:

Developer incorrectly handled message that requests What's This? Help.

How to correct it:

Print a copy of the Map IDs report and give it to your developer. It lists the names of each topic ID and its corresponding map number and the name of the map file that uses it.

Text-only topics are indicated by "Text-only Popup MapID." Your developer should be able to recognize the topic IDs and the map numbers from this report to correct the problem.

Compile the project and retest using the updated .CHM file.


Symptom:

The wrong topic is displayed or no topic is displayed.

Error message:

1. No message

OR

Command: HH_TP_HELP_WM_HELP?HH_TP_HELP_CONTEXT_MENU

Processing Project_Name.chm

Control ID: 1174

Help ID: 1003

File: Folder_Name/FileName.TXT

Cause of problem:

The map number in the map file is missing its matching topic ID.

OR

The topic ID is matched to the wrong topic.

How to correct it:

If the problem is caused by a missing topic ID make the fix to the appropriate map file.

For developer-supplied map file, update the map file with a copy that has the correct map number and its matching topic ID.

For auto-generated map file, open the Context-Sensitive Text-Only Topics dialog, select the map number, enter the topic ID and click Add/Update.

If the problem is caused by a topic ID matched to the wrong topic, remove the text-only topic and create a new one for the topic ID.

Compile the project and retest using the updated .CHM file.