Adding context help to your application expands the use and enhances the user experience. The context help can be recognized by the arrow cursor associated with the question mark. Dialog boxes supporting this can be recognized by the ? icon in the upper right-hand corner of the box. How to install Microsoft HTML Help 1.4 SDK... read the story at Microsoft.
If the users have trouble understanding the function of some of the controls, the solution is to click the icon, move the cursor into the control of question, and left-click the mouse. Alternative is for controls that have input focus without generating a command message (like edit controls), is simply pressing the F1 key that has the same effect. A popup window appears containing help text that you declared.
Adding context help using the HTML popup can be described in four steps:
- Enable the context help for the dialog at the 'Dialog Properties' 'Extended Styles' page.
- Assign help text for the control in your 'String Table'.
- Trap the
WM_HELPINFO message in the dialog box class.
- Copy-paste the code below into your desired class.
It is important that the ID used in your String Table is the same you named the control, try using the combo box at the 'String Properties' dialog.
Ready for Message Handler
The message handler for the
WM_HELPINFO message goes like this:
afx_msg BOOL OnHelpInfo(HELPINFO* pHelpInfo);
BOOL CDlg::OnHelpInfo(HELPINFO* pHelpInfo)
As mentioned in the comment, the
ShowContextHelp(...) is the method that has our attention. The method takes three arguments: a pointer to the window, the
POINT structure where the help request occurred, and the identification for the control.
void CDlg::ShowContextHelp(CWnd* pWnd, POINT pt, int iCtrlID)
memset(&hPop, 0, sizeof(hPop));
hPop.cbStruct = sizeof(hPop);
hPop.clrBackground = RGB(255, 255, 208);
hPop.clrForeground = -1; hPop.rcMargins.left = -1;
hPop.rcMargins.bottom = -1;
hPop.rcMargins.right = -1;
hPop.pt = pt;
hPop.pszText = s; hPop.pszFont = NULL;
HH_POPUP structure is used to display the context help in a popup window. The structure has members for setting the foreground/background colors, for adjusting where the popup will be displayed, and for selecting the font to use. If you skip the first parameter, by typing
NULL, you will experience that the popup window is acting like a modeless dialog, which was not the intention.
The second parameter for the
HtmlHelp(...) method points to a file object where the string resource also could be placed.
Hope you will find it useful.