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.
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
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
Ready for Message
The message handler for
WM_HELPINFO message goes like this:
afx_msg BOOL OnHelpInfo(HELPINFO* pHelpInfo);
BOOL CDlg::OnHelpInfo(HELPINFO* pHelpInfo)
As mentioned in the
ShowContextHelp(...) is the
method that has our attention. The method takes three
arguments: a pointer to the window, the
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;
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
you will experience that the popup window is acting like
a modeless dialog, which was not the intention.
The second parameter
method points to a file object where the string resource
also could be placed.
Hope you will find it