CWinApp::WinHelp

virtual void WinHelp( DWORD dwData, UINT nCmd = HELP_CONTEXT );

参数:
dwData指定了附加数据。这些值依赖于nCmd参数的值。
nCmd指定了请求的帮助类型。可能取值的列表以及它们影响dwData参数的方式参见Windows函数WinHelp。

说明:
调用这个函数以激活WinHelp应用程序。框架也会调用这个函数以激活WinHelp应用程序。
当你的应用程序终止时,框架会自动关闭WinHelp应用程序。

示例:
// 头文件: HELPIDS.H
//
// 这个例子的头文件被包含了两次:
// (1) 它被.CPP文件包含,将DWORD类型的上下文ID传递给CWinApp::WinHelp。
// (2) 它被包含在.HPJ文件中的[MAP]部分,将帮助上下文字符串“HID_MYTOPIC”与帮助上下文ID101关联起来。
// 帮助上下文字符串“HID_MYTOPIC”标识了帮助// 的.RTF源文件中的帮助主题,带有“#”脚注:
//     # HID_MYTOPIC
//
// 没有必要用这种方式管理在RESOURCE.H文件中定义的与命令对象或用户界面对象相关的帮助主题的帮助上下文ID。
// 你可以使用MAKEHM工具,或者是AppWizard的上下文帮助选项所生成的MAKEHELP.BAT文件来为这些ID生成帮助映射(.HM)文件。
// 仅对那些不与命令对象或用户界面对象相关的帮助主题才有必要
// 按照这里演示的方式管理帮助上下文ID。
#define HID_MYTOPIC 101
// 显示了在帮助的.RTF文件中具有上下文字符串
// “HID_MYTOPIC”的自定义帮助主题,它被映
// 射到HELPIDS.H文件中的DWORD型ID值HID_MYTOPIC。
AfxGetApp()->WinHelp(HID_MYTOPIC);
// 下面是MAKEHM工具生成的帮助映射(.HM)文件
// 中的一行代码,随后它被AppWizard的上下文帮助
// 选项所生成的MAKEHELP.BAT文件所调用。
// MAKETM工具读出应用程序的RESOURCE.H文件中
// 的#define语句:
//    #define ID_MYCOMMAND 0x08004
// 然后加上一个帮助ID的偏移量0x10000以创建帮助上
// 下文的DWORD值0x18004。有关帮助ID偏移量的更
// 多信息参见MFC的技术注释28。
HID_MYCOMMAND 0x18004
// 你很少需要利用帮助上下文ID为命令或用户界面对象
// 直接调用WinHelp。例如,当焦点位于My Command菜
// 单项上时,如果用户按下F1键,框架就会自动调用WinHelp。
// 但是,如果你想要为与命令相关的帮助主题直接调用WinHelp,
// 下面是调用的方法:
AfxGetApp()->WinHelp(0x10000 + ID_MYCOMMAND);

请参阅:
CWinApp::OnContextHelp, CWinApp::OnHelpUsing, CWinApp::OnHelp, CWinApp::OnHelpIndex, ::WinHelp