What code do the developers write so context-sensitive Help works with an application? They write what's known as a context-sensitive HTML Help function call.
The code looks something like this:
HtmlHelp(hWnd, /*Window handle of program or dialog*/
"CSHHelp.chm", /*Name of the CHM file*/
HH_HELP_CONTEXT,
dwMapNumber); /*Map number from map file*/
Note: Information enclosed in /* */ characters are developer's comments.
HtmlHelp(hWnd: This is the window handle of a program or dialog. A window handle serves as a way to identify a window so the HTML Help engine knows which application is performing the specific action.
CSHHelp.chm: This is the name of a compiled HTML Help file (.CHM) that includes context-sensitive Help. The author provides the developer with this file so it can be used with the application. (In actual code, "CSHHELP.chm" would be a unique name, for example, RoboHELP.chm.)
HH_HELP_CONTEXT: This is the command sent to the HTML Help engine for window-level Help. (A command such as HH_TP_HELP_WM_HELP is used for What's This? Help.)
dwMapNumber): A map number from the map file.