VC程序使用chm帮助文件

Posted on 2005-12-19 09:30 Raistlin 阅读(1877) 评论(1)  编辑 收藏 引用 所属分类: C++
   最近在做一个安装程序。想要弄一个上下文相关帮助。
    一开始想用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);//
   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了。
注:// Help ID bases(afxpriv.h)
#define HID_BASE_COMMAND    0x00010000UL        // ID and IDM
#define HID_BASE_RESOURCE   0x00020000UL        // IDR and IDD
#define HID_BASE_PROMPT     0x00030000UL        // IDP
#define HID_BASE_NCAREAS    0x00040000UL
#define HID_BASE_CONTROL    0x00050000UL        // IDC
#define HID_BASE_DISPATCH   0x00060000UL        // IDispatch help codes
 
如何调用HtmlHelp:
   微软在提供html help workshop的时候提供了调用方法,就是在html help workshop的安装目录下提供了个头文件和静态库,这个库的作用是装载hhctrl.ocx(system32目录下),调用其中真正的htmlhelp方法。具体见:
 http://www.yesky.com/SoftChannel/72342376173010944/20010409/165483.shtml

Feedback

# re: VC程序使用chm帮助文件  回复  更多评论   

2008-07-18 09:07 by 许阳
你好,我这两天在用VC做一个调用chm的东西,程序编译度没问题,可是运行老出错,说是内存问题,希望您给予指点,我的邮箱是dragonfly_xyl@126.com,急!!!!
谢谢
只有注册用户登录后才能发表评论。

posts - 49, comments - 14, trackbacks - 0, articles - 0

Copyright © Raistlin