加帮助文件

CHM文件是微软公司开发的新一代基于HTML的帮助文件格式，它一问世就以其易用性和新颖的界面赢得了广大编程一族的喜爱，目前大多数软件都用它来制作应用程序的帮助文件。关于Html Help Workshop的用法已有文章介绍，在这里笔者着重讲述在实际编程中如何调用CHM文件，从而建立起应用程序的帮助系统，本文以VisualBasic 6.0为语言平台。声明HtmlHelp API函数由于HtmlHelp API 并没有集成在Windows操作系统的API中，因此不能直接调用HtmlHelp.lib 库函数，但HtmlHelp API的功能位于hhctrl.ocx中，这样可以通过调用hhctrl.lib库函数来显示帮助文件，其声明格式如下：
Declare Function Htmlhelp Lib "hhctrl.ocx"Alias "HtmlHelpA"
(ByVal hwndCaller As Long,
ByVal pszFile As String,
ByVal uCommand As Long,
ByVal dwData As Any) As Long
具体参数含义如下：
hwndCaller 调用该函数的窗体句柄
pszFile 帮助文件的名称和位置
uCommand 帮助类型
dwData 与uCommand相匹配的附加参数定义uCommand 常数Const HH_DISPLAY_TOPIC = &H0
Const HH_DISPLAY_INDEX=&H2
Const HH_HELP_CONTEXT = &HF
Const HH_DISPLAY_SEARCH= &H3
Const HH_DISPLAY_TEXT_POPUP= &HE
接着指定CHM文件的名称和位置：
App.HelpFile=App.Path & "\Sample.CHM"
程序调用
调用缺省主题帮助
Call HtmlHelp(hwnd,
App.HelpFile,
HH_DISPLAY_TOPIC,
ByVal "Default.htm")
此调用方式用于没有上下文ID号的情形，dwData可指定一个在CHM文件内的缺省htm文件，也可取NULL，这是HtmlHelp API最基本的一种用法。调用关键字帮助Call HtmlHelp(hwnd,
App.HelpFile,
HH_DISPLAY_INDEX,
(DWORD)"关键字"))
此调用方式中dwData取索引文件（.hhk）中存在的关键字。
调用上下文敏感帮助
Call HtmlHelp(hwnd,
App.HelpFile,
HH_HELP_CONTEXT, 1000)
此调用方式用于含有映射信息的CHM文件, dwData取映射表中存在的ID号。
调用全文搜索帮助
Dim Query As HH_FTS_QUERY
Call HtmlHelp(hwnd,
App.HelpFile,
HH_DISPLAY_SEARCH,
(DWORD)& Query)
DwData参数指定一个指向HH_FTS_QUERY结构的指针。调用弹出式帮助Dim Popup As HH_POPUP
Call HtmlHelp(hwnd,
NULL,
HH_DISPLAY_TEXT_POPUP,
(DWORD)&Popup)
PszFile通常取NULL，也可以指定一个CHM和一个在该CHM文件中的TEXT文件，DwData用于指定一个指向HH_POPUP结构的指针。指定显示窗体形式
由于显示帮助文件的缺省窗体是在编译该CHM文件时的窗体，因此为了更好地控制帮助文件的显示，在制作CHM文件时，可以自定义一个窗体形式。在程序中可以通过两种方法来调用自定义窗体。
1.当uCommand 为HH_DISPLAY_TOPIC或HH_HELP_CONTEXT时，在pszFile参数中用“＞”符号，其后跟上窗体名称即可。如pszFile取：
App.HelpFile & "＞ MainWin"
2.用HtmlHelp函数直接指定：
Dim WinType As HH_WINTYPE
Call HtmlHelp(hwnd,
App.HelpFile &" ＞ MainWin",
HH_SET_WIN_TYPE,
(DWORD) &WinType)
必须声明的是，以上叙述中使用的“Sample.CHM”、“Default.htm”、“关键字”、“1000”和“MainWin”等均属举例，应用中需要根据自己的具体情况来设置这些参数的实际值。至此，应用程序的帮助系统就建立起来了，当然，要把帮助系统做得更完美一点，还有更多的工作要做。

http://www.tf163.com/flashion/list.asp?unid=1480

VB里实现帮助文件速成
作者：-
---- 带有帮助文件的应用程序无论对程序员还是用户都是不同凡响的，它能节省印刷大量用户手册的开支，对程序员编辑修改和用户手册的复制保存都极为方便。帮助文件的另一个很有前景的应用是单独作为带有图文信息的电子图书发布。 ---- 在此对帮助文件的编制及如何在程序中编程调用作一详尽介绍。首先介绍第一部分，帮助文件的编写。 ---- 帮助文件的编写步骤：先编写存有所有帮助信息的帮助源文件RTF 文件。编写帮助项目文件HPJ 文件。对HPJ 文件编译，最后生成HLP 文件。
帮助源文件RTF 文件的编写
---- 帮助源文件是存有所有帮助信息的，这是一种RTF（Rich Text Format) 文件, 帮助文件象一本书，由目录及一个个章节组成，各章节之间的跳转是由定义的热点来完成。现在举一具体例子（由目录等五条信息组成）详细说明。 ---- 原始信息由五个章节组成：目录、概述、说明、程序、安装。象前面每一节的标题（“ 目录”，“ 概述”， “ 说明”，“ 程序”， “ 安装”）在RTF 文件中必须以特有的脚注（即$) 明确指定。对每一节还须指定其跳转名( 脚注是# ，跳转名不能是汉字），以便标识，在这我们给每一节分别取名为：contents , description, explanation ,programming, setup, 对每一节还可指定其搜索关键字（脚注是K），关键字可以是一个或多个，汉字和英文均可。 ---- 具体操作如下：进入Microsoft Word 中文版, 选择：文件/ 新建，先输入第一节的内容：输入第一节的标题：“ 目录”，将光标移到“ 目录” 的前面，选择系统菜单的“ 插入”，选 “ 脚注和尾注”，选“ 脚注” 和“ 自定义标记”，输入：$ 符号，这时文档下方出现脚注编辑窗口，光标也自动落在文档下方的脚注编辑窗口中，在光标处接着输入这一节的标题：“ 目录”，有时看不到文档下方的脚注窗口，这只要将系统菜单中“ 视图” 的“ 脚注” 选上。 ---- 下面定义这一节的跳转名, 将光标移到“ 目录” 的前面，选择系统菜单的“ 插入”，选 “ 脚注和尾注”，选“ 脚注” 和“ 自定义标记”，输入：# 符号，这时文档下方出现脚注编辑窗口，光标也自动落在文档下方的脚注编辑窗口中，在光标处接着输入这一节的跳转名：“contents”( 有时看不到文档下方的脚注窗口，这只要将系统菜单中“ 视图” 的“ 脚注” 选上) 定义这一节的搜索关健字。将光标移到“ 目录” 的前面，选择系统菜单的“ 插入”，选 “ 脚注和尾注”，选“ 脚注” 和“ 自定义标记”，输入：k 符号，这时文档下方出现脚注编辑窗口，光标也自动落在文档下方的脚注编辑窗口中，在光标处接着输入这一节的搜索关健字，搜索关健字可以是中文或英文，一个或多个，中间用分号（即；）隔开，这儿我们输入：目录；目次；contents。 ---- 最后定义这一节的顺序号。顺序号相当于一本书中各章节的页码。将光标移到“ 目录” 的前面，选择系统菜单的“ 插入”，选 “ 脚注和尾注”，选“ 脚注” 和“ 自定义标记”，输入：+ 符号，这时文档下方出现脚注编辑窗口，光标也自动落在文档下方的脚注编辑窗口中，在光标处接着输入这一节顺序号，如：0001，0002，0003 等。这儿我们输入：0001. ---- 这样，第一节的脚注标记全部作完。 ---- 第二节的脚注标记作法一样。（第一节和第二节要有分页符，选择系统菜单的“ 插入”，选 “ 分隔符”，“ 分页符”）。 ---- 在帮助文件中，当用户在按了绿色的跳转文本，就应该跳转到对应的章节，如何定义一个热点跳转呢？因为我们已经定义了第一节的跳转名，只要将跳转文本与要跳转到的那一节的跳转名联系起来，跳转文本在RTF 文件中是带双下划线的文本，以上例操作如下： ---- 选择系统菜单上的“ 格式”/“ 字体”，选择“ 字体”/“ 下划线”，选“ 双线”，然后开始输入热点文本，这儿我们输入“ 概述”，输入完热点文本，清除双下划线格式，操作：选择系统菜单上的“ 格式”/“ 字体”，选择“ 字体”/“ 下划线”，选“ 无”，清除双下划线格式后，紧接着选择隐藏文本格式，输入跳转目的地的跳转名，操作：选择系统菜单上的“ 格式”/“ 字体”，选择“ 字体”/“ 效果”，选“ 隐藏”，输入跳转目的地的跳转名，这儿输入“description”，输入完清除隐藏文本格式。清除隐藏文本格式的操作：选择系统菜单上的“ 格式”/“ 字体”，选择“ 字体”/“ 效果”，将“ 隐藏” 复选框除去。 ---- 如何定义热点弹出说明。它与以上热点跳转文本一样，只不过它是带单下划线的文本。操作如下：选择字符的单下划线格式，输入弹出式热点文本，如上例输入的是“ 单下划线的指定说明热点”，操作如下：选择系统菜单上的“ 格式”/“ 字体”，选择“ 字体”/“ 下划线”，选“ 单线”，然后开始输入热点文本，这儿我们输入“ 单下划线的指定说明热点”，输入完热点文本，清除单下划线格式，紧接着选择隐藏文本格式，输入跳转目的地的跳转名，这儿是弹出窗口的跳转名：这儿输入“my_pop_up”，输入完清除隐藏文本格式。弹出窗口一节要与其它章节用分页符分开。只要指定跳转名即可。 ---- 我们经常看到的“ 参阅”、“see also” 弹出窗口就是这样作出来的。 ---- 如何对图形指定热点跳转。在RTF 文件中使用图形，可以用语句：{bmc 图形文件名}，bmc 表示图形放在中间，bml 表示图形放在左边，bmr 表示图形放在右边，图形文件可以是一般的BMP 位图和SHG 热点跳转图形文件。 ---- 如用户在图形某处按动时，会弹出一个说明窗口。而热点图形.shg 文件由.bmp 位图文件通过工具软件Hotspot Editor 编辑而来。Hotspot Editor 是随Visual Basic （在VB 的HC 目录下）和Visual Foxpro（在VFP 的HELPCOMP 目录下）发布的。执行文件名是SHED.EXE。操作：运行SHED.EXE，选File/Open，装入要用到的位图文件。这儿用一人头形位图man.bmp, 在图形上拖动，产生一个个热点，双击任一热点区域，出现一对话框，只要在Context String 处输入要跳转或弹出目的地的跳转名。热点类型Type 处选取 Jump 跳转式或 Popup 弹出式。热点区域边框属性Attribute 选取可见Visible 或不可见Invisible。在这个例子中Context String 输入eye_popup,Type 选取 Popup,Attribute 选取Invisible ( 隐去热点区域的边线).

---- 以d:\winword\man.shg 文件名存盘，退出SHED.EXE。 ---- 如何产生固定的不滚动标题区域，不滚动区域，在显示特长的信息时很有用，可这样操作：用光标将要不滚动的区域全选上，点取系统菜单上的“ 格式”/ “ 段落”，选“ 正文排列”，将“ 与下段同页” 选上。 ---- 就这样，帮助信息源文件所有的工作都已作完，在WORD 中将文件以RTF 格式存盘。下面进入帮助项目文件HPJ 的编辑。建立帮助项目文件（.HPJ 文件）
以一实例说明，语句分号右边是注解
[OPTIONS] ; 这一节的内容并非必须
COMPRESS=0 ; 指示HLP 文件不压缩
ERRORLOG=my.err ; 编译错误存于此文件
REPORT=Yes ; 编译时报告
CONTENTS=contents ; 目录跳转名
COPYRIGHT= ; 版权信息
DEFFONT=,10,0 ；字体大小
BMROOT=. ; 指示BMP 文件的存放位置，
在同一目录下用空白或“.” 否则BMROOT=Drive:\Path
HLP=.\dxchlp.hlp ; 表明生成的帮助文件名
[FILES] ; 唯一重要的一节
.\Dxchlp.rtf ; 所用RTF 文件名（包括路径）
---- [WINDOWS] ; 语法 Main=" 主窗口的标题",( 窗口水平位置，垂直位置，宽度，高度），状态，背景颜色（R，G，B），非滚动区域背景颜色（R，G，B），是否总是浮在其它窗口上面（0 为False,1 为True) 例： ---- Main=“ 主窗口标题”，（512,10,512,1000),0,(255,251,240),(192,192,192),0 ---- ；语法： Second=; 语法同上面主窗口，例： ---- Second=“ 次级窗口标题”，（10,10,500,1000),0,(254,251,240),(191,192,192),1 ---- [CONFIG] ---- BrowseButtons() ；加一向前向后按钮 ---- 其实用不着写这么多，最省事的帮助项目文件是这样只有一条语句，其它全是缺省值： ---- [FILES] ；节名称 ---- Myhelp.rtf ；所用RTF 文件名（包括路径, 如c:\winword\Myhelp.rtf） ---- 以上hpj 文件用任何编辑器编辑后以HPJ 文件存盘。对帮助项目文件HPJ 进行编译，形成HLP 文件
---- 编译要用编译工具HC.EXE，在VB 的HC 目录下有HC.EXE，在VFP 的HELPCOMP 目录下有HC31.EXE 和HC35.EXE，任选一个使用。操作：HC 文件名，或HC31 文件等, 如：HC31 Myhelp.hpj
--------------------------------------------------------------------------------
---- 现在介绍第二部分，对帮助文件编程。 ---- 帮助文件的最终目的是要应用到自己程序中。现以最常用的三种开发工具VB，VFP，DELPHI 分别举一最简单例子。 VB
---- 进入VB，选File/New Project，出现一空白窗体Form1, 加一个通用对话框CommondDialog1 到Form1，点取Menu Editor，设置一菜单，一级菜单有二项：（Caption 分别为：）File ，Help，而File 的下一级菜单Exit，Help 的下一级菜单为Contents， KeyWords Search， About，对应的Name 属性分别为:mnuFile，mnuHelp，mnuExit，mnuContents，mnuSearch，mnuAbou。假定帮助文件是D:\WINWORD\DXCHLP.HLP。 ---- 程序代码如下： Private Sub Form_Load()
CommonDialog1.HelpFile = "d:\winword\dxchlp.hlp"
End Sub Private Sub mnuContents_Click()
With CommonDialog1
.HelpCommand = cdlHelpContents 'cdlHelpContents 是显示目录的命令
.ShowHelp
End With
End Sub Private Sub mnuSearch_Click()
With CommonDialog1
.HelpCommand = cdlHelpKey 'cdlHelpKey 是显示关健字搜索的命令
.ShowHelp
End With
End Sub Private Sub mnuAbout_Click()
aboutform.Show 1 ' 以模态显示" 关于" 窗口
End Sub Private Sub mnuExit_Click()
End
End Sub 以上可用调用动态联结库的方法，代码如下：
（1）模块文件：
Global Const HELP_CONTENTS = &H3&
Global Const HELP_KEY = &H101 Declare Function WinHelp Lib "user32" Alias "WinHelpA"
(ByVal hwnd As Long, ByVal lpHelpFile As String, ByVal
wCommand As Long, ByVal dwData As Long) As Long '
必须同一行; 为WIN95,NT
' Declare Function WinHelp Lib "User" (ByVal hwnd As
Integer, ByVal lpHelpFile As String, ByVal wCommand As
Integer, dwData As Any) As Integer ' 必须同一行; 为WIN3.X
（2）窗体文件
Private Sub Form_Load()
App.HelpFile = "d:\winword\dxchlp.hlp"
End Sub Private Sub mnuContents_Click()
i% = WinHelp(Form1.hwnd, App.HelpFile, HELP_CONTENTS, 0)
End Sub Private Sub mnuKeySearch_Click()
i% = WinHelp(Form1.hwnd, App.HelpFile, HELP_KEY, 0)
End Sub

http://www.ccw.com.cn/htm/app/aprog/01_12_31_2.asphttp://www.vbaspnew.com/ziyuan/w/ct/22.txt

解决方案 »