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