VC程序使用chm作为上下文相关帮助

类别:VC语言 点击:0 评论:0 推荐:

废话:
    最近在做一个安装程序。鉴于用户对数据库啊,应用服务器啊不可能那么熟悉,所以想要弄一个上下文相关帮助。
    一开始想用vc6自带的上下文相关帮助。在建立工程的时候选择context-sensitive help即可。嗯,vc帮我创建了AfxDlg.rtf、setup.cnt、setup.hm、setup.hpj、setup.ph等文件,以为省事了,用word打开AfxDlg.rtf一看,完全不会编辑。看了《inside visual c++》里面的文章,还是一头雾水。
    winhelp这老掉牙的东西,在win98年代就被htmlhelp淘汰了,俺还用它干嘛?决定弃暗投明,使用html help workshop来做帮助。html help workshop是一款制作chm文件的工具,微软免费提供,到处有的下。使用起来也方便,比编辑rtf格式要方便多得多,基本方法是把制作好的网页往里面塞,不浪费口舌了。

原理:
    用html help workshop制作chm是方便,关键是怎么让它可以"上下文相关"。程序里调用chm帮组文件的api是
    HWND HtmlHelp(HWND hwndCaller, LPCSTR pszFile, UINT uCommand, DWORD dwData);
    简单啊。废话少说,更改App类的WinHelp()方法如下:
 void CSetupApp::WinHelp(DWORD dwData, UINT nCmd)
 {
  ::HtmlHelp(NULL, "E:\\workshop\\setup\\hlp\\chmtest.chm", HH_HELP_CONTEXT, dwData);
 }
    当然啦,具体文件在哪请你自己具体分析。这里要说的是这个dwData可是很有来头的,设个断点你就可以看个清楚了:
 ID_HELP命令的消息路径是:
 CWnd::OnWndMsg()
 CDialog::OnCommandHelp()具体:
 LRESULT CDialog::OnCommandHelp(WPARAM, LPARAM lParam)
 {
  if (lParam == 0 && m_nIDHelp != 0)
   lParam = HID_BASE_RESOURCE + m_nIDHelp;//m_nIDHelp就是你的对话框的id哦
  if (lParam != 0)
  {
   CWinApp* pApp = AfxGetApp();
   if (pApp != NULL)
    pApp->WinHelp(lParam);//注意看这里,这就是为什么要改App类的WinHelp()
   return TRUE;
  }
  return FALSE;
 }

如何写CHM:
    现在要做的就是把dwData和想要显示的东西关联起来。还好有了网络我们身边有很多专家:
 具体方法是:
 1、使用记事本建立一个文本文件,文件名为Map.h。在该文件中输入下面的内容:
 #define TOPIC1 100
 #define TOPIC2 200
 这里TOPIC1、TOPIC2是一些常量,100、200是你在API调用时指定的ContextID。
 2、在HTMLHelp Workshop中选择Project标签,点击HtmlHelp API information按钮,在对话框的Map标签中选择Header File按钮,然后选择你前面建立的Map.h文件。
 3、还是在HtmlHelp API information对话框中选择Alias标签,点击Add按钮,在对话框中的Whenever This Constant or number is passed to the HTMLHelp API下输入常量,如TOPIC1。
 4、在Use it to Refer to This HTML File中选择HTML文件,如Topic1.html。
 5、重复3、4两步指定所有文件。
 6、编译文件就可以了。
 (转自http://www.china-askpro.com/msg44/qa78.shtml)
 具体的ContextID可不是100,200啊,是HID_BASE_RESOURCE+对话框ID。
 查找一下发现:#define HID_BASE_RESOURCE 0x00020000UL ,如果你的对话框ID值是0x0102那就该
 #define MYDLGID 0x20102了。

如何调用HtmlHelp:
    还真烦,在vc里调用这玩意还不是简单的小事。还好微软心肠不错,在提供html help workshop的时候提供了调用方法,就是在html help workshop的安装目录下提供了个头文件和静态库,这个库的作用是装载hhctrl.ocx(system32目录下),调用其中真正的htmlhelp方法。具体见:
 http://www.yesky.com/SoftChannel/72342376173010944/20010409/165483.shtml

疑问:
    是不是所有系统下面都有hhctrl.ocx?win98上应该都有吧?windows自己的帮助文件也是chm格式的...

本文地址:http://com.8s8s.com/it/it251.htm