怎么用VC做帮助文件

2022-04-14 社会 53阅读

VC中调用CHM帮助必须用API函数HtmlHelp(),此函数在LIB库函数内,为方便调用,我把它整体打包了,您要做的就是把它放到VC工程所在的目录,然后包含CHMHelp.h头文件即可。
系统包含文件如下:

[cpp] viewplain copy

  • #include "CHMHelp.h"  

  • BOOL CDataDlg::OnInitDialog()   

  • {  

  • CDialog::OnInitDialog();  

  • SetWindowContextHelpId(IDH_WJH_0300702025);  

  • return TRUE;  

  • }  

  • 上述代码中IDH_WJH_0300702025为在CHMHelpID.h中定义的敏感帮助的页面ID,设置了ID后在需要显示帮助的过程中(一般是用户按F1)增加如下代码:

    [cpp] viewplain copy

  • BOOL CMainFrame::OnHelpInfo(HELPINFO* pHelpInfo)   

  • {  

  • HWND hWnd;  

  • if(pHelpInfo->dwContextId > 0)   

  • hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle,   

  • theApp.m_szHelpFile,   

  • HH_HELP_CONTEXT,   

  • pHelpInfo->dwContextId);  

  • else   

  • hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle,   

  • theApp.m_szHelpFile,   

  • HH_HELP_CONTEXT,   

  • IDH_WJH_0100000000);  

  • return (hWnd != NULL);  

  • return CMDIFrameWnd::OnHelpInfo(pHelpInfo);  

  • }  

  • 上述代码即响应用户F1按键,若当前显示界面设置了热点敏感帮助的页面ID时,程序将打开CHM帮助文档并跳转到ID对应的页面;若当前显示界面没有设置热点敏感帮助的页面ID,则显示软件帮助缺省的页面。IDH_WJH_0100000000为软件的缺省显示页面ID。

    二、CHM帮助文档的制作要求

    CHM帮助文档必须包含API文档信息,包含页面ID文件和ID对应页面名称申明二个文件,格式如下:

    [cpp] viewplain copy

  • CHMHelpID.h 页面ID文件格式:  

  • #define IDH_WJH_0000000000  0  

  • #define IDH_WJH_0100000000  100000000  

  • #define IDH_WJH_0100100000  100100000  

  • #define IDH_WJH_0100101000  100101000  

  • AliasID.hID对应页面名称申明文件格式

    [cpp] viewplain copy

  • IDH_WJH_0000000000 = 用户操作手册.Content/0000000000_操   作   手   册.Htm  

  • IDH_WJH_0100000000 = 用户操作手册.Content/0100000000_第一部分 系统介绍.Htm  

  • IDH_WJH_0100100000 = 用户操作手册.Content/0100100000_第一章 主要功能.Htm  

  • IDH_WJH_0100101000 = 用户操作手册.Content/0100101000_1、基本功能.Htm  

  • IDH_WJH_0100102000 = 用户操作手册.Content/0100102000_2、高级应用功能.Htm  

  • 编制好这两文件后,包含在HHP工程文件中,用HTMLWORKSHOP进行编译就可以了。现在网上也有很多软件可以按照WORD文档的章节自动生成上述文件,极大的方便了用户制作软件热点敏感帮助。现推荐一款制作CHM的软件:Word2CHM帮助文档制作工具,此软件自动将WORD文档按照章节转换成CHM文档,并自动生成上述两个文件。您需要做的就是按照第一节介绍的方法在VC下加入代码编译软件即可实现热点敏感帮助。

声明:你问我答网所有作品(图文、音视频)均由用户自行上传分享,仅供网友学习交流。若您的权利被侵害,请联系fangmu6661024@163.com