HTML Help WorkShop 创作和调用方法和技巧
2015-10-10 19:12阅读:
一、在CHM 文件中所用到的弹出式菜单:
二、在HTML Help WorkShop
中不用显示的样式
(1)、从右到右阅读顺序。
(2)、对话框
(3)、滚动条在左边
(4)、仅展开单个标题
三、让导航窗格一直显示的方法(不显示<隐藏/显示>按钮)
第一步:点添加/更改窗口信息
第二步:
在按钮选项卡选中隐藏/显示复选框
第三步:在导航窗格选项卡属性项只勾选自动同步复选框
第四步:编译文件,并打开编译好的chm文件,单击显示按钮。
第五步:重新打开按钮选项卡取消隐藏/显示复选框的选择状态。
第六步:重新编译,导航空格将一直显示了。
四、在Visual
Basic中调用HtmlHelp帮助文件的方法
在
Visual
Basic中调用
HtmlHelp帮助文件需要用
HtmlHelp
API函数
HtmlHelp(),这个函数驻留在
HtmlHelp
ActiveX控件
Hhctrl.ocx中。因此,首先要声明
HtmlHelp():
Declare Function HtmlHelp Lib
'hhctrl.ocx' Alias 'HtmlHelpA'
(ByVal hwngcaller As Long,
ByVal pszfile As
String, ByValucommand As
Long, ByVal dwdata
As Any) As Long
其中
,参数
hwnd是窗口的句柄,
lpHelpFile是
HTML帮助文件的路径和名称,
wCommand表明执行的操作,
dwData是
wCommand参数所需要的值。
'public const hh_display_topic =
&H0
'上下文相关的帮助
(导航窗口
)
Public Const hh_display_index
= &H2
'索引窗口
'public const hh_help_context =
&HF
'上下文相关的帮助
'public const hh_display_search =
&H3
'搜索窗口
'public const hh_display_text_popup
= &HE
'上下文相关的帮助
然后调用此函数:
Public Sub
mnuHelpContents_Click()
'如果这个工程没有帮助文件,显示消息给用户
'可以在“工程属性”对话框中为应用程序设置帮助文件
On Error Resume
Next
If
Dir(CheckFilePath(App.Path) &
'记事薄
HTML帮助
.chm') = ''
Then
MsgBox
'无法显示帮助目录,可能帮助文件已被移除或损坏,请重新安装帮助文件。
',
vbInformation, '记事薄
'
Else
Call HtmlHelp(hWnd,
App.HelpFile,
hh_display_index, ByVal
'作者简介
')
If Err Then
MsgBox
Err.Description
End If
End If
End Sub
当用户按
F1键时不存在帮助文件:
Private Sub
rtfText_KeyDown(KeyCode As
Integer, Shift As Integer)
If
KeyCode = vbKeyF1 Then
Call
mnuHelpContents_Click
End If
End Sub
五、如何在Html Help
workShop中创建HelpContextID,在VB程序中按F1弹出对应的Context
1.创建帮助主题文件
2.创建帮助项目文件
2.1 HTML Help
Workshop的帮助项目文件
2.2
创建帮助项目文件
3.
创建目录(Content)文件
3.1目录和目录文件
3.2 创建目录文件
3.3
向目录文件添加目录
3.4
让目录文件包含另一个目录文件
4.创建索引(Index)
4.1
关键字(Keyword)和索引文件
4.2 创建索引文件
4.3 创建关键字
4.4
设置关键字跳转到另一个关键字
5.丰富帮助主题文件的内容
5.1
查看HTML文件的源代码
5.2 向HTML文件中插入HTML
Help
ActiveX控件
5.2.1 HTML Help
ActiveX控件简介
5.2.2 插入HTML Help
ActiveX控件的一般方法
5.2.3 向HTML
文件中插入快捷方式(ShortCut)
5.2.4
向HTML文件中插入相关主题(Related
Topics)
5.2.5
向HTML文件中插入关键字链接(KLinks)
5.2.6 向HTML
文件插入联想链接(ALinks)
5.2.7 用文字代替按钮显示HTML Help
ActiveX控件
5.3 向HTML
文件中插入JavaScript(Java脚本)
5.3.1 用正文链接代替按钮显示HTML Help
ActiveX控件
5.3.2
向HTML文件插入一个弹出式窗口(pop-up
windows)
5.4
将链接指向另外帮助文件中的主题文件
6.创建搜索(Search)
如何在
Html Help
workShop中创建
HelpContextID,在
VB程序中按
F1弹出对应的
Context。
它使用的是一个以网络超级文本(
HTML)为特征的新型帮助系统,即
HTML帮助系统。它是来自
Microsoft公司的下一代联机帮助系统,它使用
Microsoft
Internet
Explorer的基础组件来显示帮助内容,它支持
HTML、
ActiveX、
Java、脚本(
Java
脚本和
Microsoft Visual
Basic脚本)以及
HTML图像格式(
.jpeg、
.gif、
.png)。
HTML帮助文件的扩展名也由
Winhelp的
.hlp变为
.chm。一个典型的
HTML帮助系统。
创建一个帮助文件最重要的工作就是创建若干您需要的主题文件。
HTML帮助的主题文件是使用超级文本语言(
HTML)创建的
HTML文件,其扩展名是
.htm或
.html。
您可以使用
Microsoft HTML Help
Workshop创建帮助主题文件,但是笔者认为使用
Microsoft Word
97来创建更方便。因为
Word
97可以把
Word文档(
.doc)文件另存为
HTML文件;甚至
Word
97还包括一个将
.doc文件转换为
HTML文件的批量文件转换工具。这样您就可以完全按您撰稿拟文的习惯编写
Word文档文件,然后再转换成
HTML文件,而不必面对
HTML复杂的源代码。在
Word
97中还可以使用插入(
Insert)菜单定义超级链接(
HTML Help
Workshop中称为正文链接)和书签。
HTML 帮助项目
(.hhp)
文件是一个纯文本文件,可以使用任何一个字处理软件(如
Windows的记事本等)打开并编辑它。
HTML帮助项目文件将创建一个帮助文件将所需要的所有元素都联系在一起。这些元素包括帮助主题文件
(.html,
.htm)、图像文件
(.jpeg、
.gif、
.png)、索引文件
(.hhk)、内容文件
(.hhc)以及其他文件。它也包含关于如何编译一个帮助项目文件及帮助文件界面的信息。最后
HTML
Help Workshop将所有的这些内容编译成一个单个的帮助文件
(.chm) 。
进入
Microsoft HTML Help
Workshop,
RPU]vt管
]O5H&W在
File菜单下选择
New,在弹出的
New对话框中选择
Project,
HTML Help Workshop将启动
New
Project向导,跟随向导就可以创建一个帮助项目文件。在其中第三步,
Existing
Files(已存在的文件)应核选
HTML
files框,以保证在第四步中能将使用
Word
97制作的
HTML文件包括在帮助项目文件中。
帮助文件的目录类似于
Windows资源管理器的左半部分,目录文件是包含一个帮助文件的所有目录,而每个目录又包含条目名称(或条目标题)、跳转到帮助主题的捷径以及每个条目属性的文件,该文件是一个
HTML格式的文件。当用户在帮助文件的目录页中单击一个条目标题时,与该条目的标题相链接的
HTML文件将被打开。
创建目录文件有两种方法:
(
1)在
HTML Help
Workshop中打开项目文件。在
File菜单上单击
New选项,选择
Table
of
Contents,
Workshop将创建一个未命名的目录文件,将其保存。然后在项目文件窗口的
Project选项卡中单击“
Chang
project
options(改变项目选项)”按钮打开
Options对话框并进入
Files选项卡,在
Contents
File栏中选择刚保存的目录文件。
(
2)如果项目文件中尚没有包括目录文件,那么,在刚创建的项目文件的窗口中单击
Contents选项卡,
HTML
Help
Workshop将显示目录文件尚未建立的提示并允许您创建一个新的目录文件或打开一个已存在的目录文件,选择
Create
a New Contents
File(创建一个新的目录文件),单击“
OK”,
HTML Help
Workshop创建一个空的目录文件。
在
Contents选项卡中单击“
Insert a
heading”按钮,出现“
Tables of Contents
Entry”对话框,在该对话框的“
Entry
title”栏中输入条目标题,并单击“
Add”按钮为条目添加链接的帮助主题。
单击“
Advanced”选项卡,在“
Image
index”栏中为条目指定图标,如包含其他条目的条目可以用书形图标,而其他条目用问号图标。
在
Contents选项卡中单击“
Insert a
Page”按钮;如果在单击“
Insert a
Page”按钮之前,您选择的条目不包括别的条目且不被别的条目所包括,那么,
HTML Help
Workshop将询问您是否要创建一个起始条目,否则单击该按钮将会增加一个子条目。
Contents选项卡中的其他按钮的功能包括:删除一个条目、改变一个条目的位置和级别以及修改目录的属性。
打开目录文件,选择一个条目,鼠标右键单击,在弹出的菜单中单击“
Insert
File”,在出现的
Include
File对话框中选择另外一个目录文件(
.hhc),在您选择的条目下将出现一条语句:
INCLUDE:filename.hhc,其中
filename.hhc代表您要包含的带路径的目录文件名。
关键字是用户可能用到的并与一个或多个帮助主题文件关联在一起的字、词或短语。索引文件
(.hhk)也是一个
HTML文件,它包含若干个关键字。当用户在编译过的帮助文件里单击索引页并选择一个关键字时,帮助文件将显示与这个关键字有关的帮助主题或显示有关帮助主题的标题的列表。
创建索引文件的方法与创建目录文件完全相同。
打开项目文件,在
Index选项卡中单击“
Insert a
Keyword”按钮,出现“
Index
Entry”对话框(该对话框与“
Tables of Contents
Entry”对话框十分相似),在“
General”
选项卡的
Keyword栏中输入关键字的名称,单击“
Add”按钮指定与该关键字相关联的帮助主题文件。
打开索引文件,选择你需要跳转到另一个关键字的关键字,单击“
Edit
Selection”按钮,在“
Index
Entry”对话框中单击“
Advance”选项卡(见图
6),核选“
Destination
is Another Keyword(目的地是一个关键字)”框。单击“
General”
选项卡,单击“
Add”按钮,在“
File or
URL”框中,输入您需要跳转到的关键字,单击“
OK”。
查看
HTML文件的方法有两种。
(
1)在
HTML Help
Workshop的
File菜单上单击
Open打开一个
HTML文件。
(
2)在项目文件的“
Project”选项卡或“
Contents”选项卡中双击一个
HTML文件或先选择一个
HTML文件,
*xXo|M6软专
6pf然后单击“
View
HTML Source”按钮。
HTML文件的源代码将显示在项目文件窗口的右半部分。
HTML Help
ActiveX控件是
ActiveX控件的一种,它是针对
HTML帮助而设计的。向帮助主题文件中插入
HTML
Help
ActiveX控件使您可以为您的帮助文件添加诸如快捷方式、相关主题、
KLinks及
Alinks等帮助文件的特征。
HTML
Help
ActiveX控件所提供的功能和界面能在支持
ActiveX技术的浏览器中显示。
(
1)在
Workshop中打开一
HTML文件。
(
2)把光标放在
HTML文件
BODY部分的您希望
ActiveX控件出现的地方。
(
3)在“
Tags(标签)”菜单上,单击
HTML
Help Control
(
HTML帮助控件),出现
HHCTRL向导。
第一步,在该对话框的“
Specify the
command(指定命令)”栏中选择一个您将使用的命令名字,在
ID
name栏输入控件的
ID名称;第二步选择控件的显示类型,缺省的显示类型为按钮(
Button);接着按屏幕上的提示继续操作即将
HTML帮助控件插入
HTML文件。向
HTML文件中插入
HTML
Help ActiveX控件都采用这种方法,以下不再赘述。
使用一个快捷方式可以在帮助文件中打开或初始化一个可执行的程序。例如,用户可以在帮助文件中单击一个按钮或者一个链接(如
Windows
98帮助中的单击此处)来启动一个可执行的程序如(
Windows的记事本)或对话框(如
Windows的添加
/删除程序对话框)。插入快捷方式的步骤如下:
(
1)在
HHCTRL向导的第一步(见图
7)的
Specify
the command栏中选择“
ShortCut”。
(
2)在
HHCTRL向导的“
ShortCut”对话框(见图
8)中输入该快捷方式要启动的程序名称(如
Notepad.exe)及参数。
相关主题是出现在某个主题文件中包含与该主题文件相关的主题文件的链接的
HTML Help
ActiveX控件。插入相关主题的步骤如下:
(
1)在
HHCTRL向导的第一步(见图
7)的“
Specify
the command”栏中选择“
Related Topics”。
(
2)在
HHCTRL向导的“
Related
Topics”对话框中输入相关的主题文件的标题和路径。
关键字链接(
Keyword
Links)简称
KLinks,它是在已经加入到帮助主题文件中的关键字的基础上建立的。当用户在帮助文件中单击
KLinks按钮或链接时包含
Keyword(与该
Klink中的
Keyword相同)的主题文件的标题将列表显示。当在帮助主题文件中增加或减少关键字的时候,
Klinks也自动地更新。使用
Klink也能跳转到另外的帮助文件的主题文件。
5.2.5.1
创建Klinks
创建
Klinks的步骤如下:
(
1)向
HTML文件加入关键字
①打开
HTML文件,
DmnoK供
EXzA9业
并将光标定位在
BODY部分需要加入关键字的地方。
②在
Edit菜单上单击“
Compiler
information(编译信息)”,启动
Compiler
information对话框,单击
Keywords选项卡。在
Keywords选项卡中单击“
Add”按钮,接着指定关键字;可以指定多个关键字,并用分号将它们分隔开。
(
2)向
HTML文件插入关键字链接
向
HTML文件插入关键字链接实际上就是向
HTML文件插入一个命令为“
Keyword
Search”的
HTML Help
ActiveX控件,其方法如
5.2.1节所述,其中需要说明的步骤如下:
①在
HHCTRL向导的第一步的“
Specify the
command”栏中选择“
Keyword Search”。
②在
HHCTRL向导的“
Keyword
Search”对话框中单击“
Add”按钮,件
Tc^8%1LFxmVy7y_络输入已在
Compiler
information对话框定义的关键字。
5.2.5.2
将Klinks关键字包括在索引文件中
在“
Chang project options”对话框的“
Files”
选项卡(见图
3)中核选“
Include Keywords from HTML
files(包括
HTML文件中的关键字)”框,
Klinks关键字将被包括在索引文件中。
联想链接(
Associative
Links)简称
ALinks,它是在已经加入到帮助主题文件中的
Alink
Names的基础上建立的。当用户在帮助文件中单击
ALinks按钮或链接时包含
Alink
Name(与该
ALink中的
Alink
Name相同)的主题文件的标题将在一个对话框或弹出菜单中显示。与关键字不同的是帮助文件用户决看不到
ALink
Name。
创建
Alinks的步骤除以下两点外与创建
Klinks的方法完全一致,
O[gFr(,ge(T有区别的两点是:
(
1)在
Compiler
information对话框中要单击
Alink
Names选项卡(见图
10)。
(
2)在
HHCTRL向导的第一步(见图
7)的“
Specify
the command”栏中选择“
ALink
Search”。
5.2.7
用文字代替按钮显示HTML Help
ActiveX控件
用以上所述的方法向
HTML文件加入
HTML Help
ActiveX控件之后,
HTML Help
Workshop在
HTML文件中也加入了一个
Object标签如下:
1hhctrl
type='application/x-
oleobject'
2
classid='clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11'
3
codebase='hhctrl.ocx#Version=4,72,7325,0'
4 width=100
5 height=100
6 >
7 KLink'>
8 Text:KLinks'>
9
10 '>
11
这是一个典型的
HHCTRL向导所加入的标签(不包括左面的行号),根据插入
HTML Help
ActiveX控件时选择的命令不同其中第
7行的“
value”值有所不同。从第
8行可以看出
HTML
Help
ActiveX控件在
HTML文件中缺省地以按钮的方式显示,要想以文字代替按钮,只要将“
Button”改成“
Text”就可以了,这时第
8行的“
value”值也从原来显示在按钮上变为作为单独的文字来显示
HTML
Help
ActiveX控件,它是不带下划线的,要想改成带下划线的文字只需在第
8行和第
9行之间加入类似下面的语句:
<<span class='SpellE'>param
NAME='
fONT'
VALUE='VERDANA,8,0x000800,underline'>如果您在
HHCTRL向导中选择的不是以文字显示在按钮上,那么第
8行的“
value”值也要修改成“
Text:xxx”的形式。
请注意,本问题与
5.2.7有所不同,
5.2.7中显示
HTML
Help ActiveX控件的方式是带下划线的文字,而本问题却是以正文链接来显示
HTML Help
ActiveX控件,其实是在
HTML文件中又加入了
JavaScript,实现的方法是:在创建
HTML
Help
ActiveX控件时的
HHCTRL向导的第二步(见图
7)中选择“
Hidden(
only
used for
scripting)
[隐藏(仅为脚本使用)
]”,
mu*:!Jd,C8H|
创建好
HTML Help
ActiveX控件之后,在
Object标签的下面加入类似以下的标签:
KLink text link
下面是一个典型的正文链接标签:
a
text link
从以上两个标签的比较可以看出新加入的标签确实是一个正文链接(在
Word
97中叫超级链接),区别是用一个
JavaScript语句代替了链接要跳转到的
HTML文件。新加入标签中的“
hhctrl1”是在
HHCTRL向导的第一步所填入的
HTML
Help ActiveX控件的“
ID Name”。
5.3.2
向HTML文件插入一个弹出式窗口(pop-up
windows)
弹出式窗口是一个弹出在帮助主题之上的窗口。它的样式能自动调整大小,以恰好容纳它里面所有的文字和图像。弹出式窗口一直保持在屏幕之上直到用户用鼠标单击其内部或外部的任何地方。
要向
HTML文件插入一个弹出式窗口,只需在
HTML文件中加入类似于下面所列的语句:
JavaScript:hhctrl.TextPopup('This
is how a pop-up window
looks.','Verdana,10',9,9,-1,-1)>here
可以看出,以上语句也是一个修改了的正文链接。其中,括号中的文字就是显示在弹出式窗口中的文字,您可以按该语句所示的格式修改成您需要的文字。
将链接指向另外帮助文件中的主题文件的方法是将链接所指的帮助主题文件改成以下形式:
*.chm::/*.htm。其中第一个
*号代表另外的帮助文件的文件名,第二个
*号表示第一个
*号所表示的帮助文件中的帮助主题的文件名。
帮助文件的
Search选项卡允许用户在帮助文件的所有主题文件中搜索与用户在
Search选项。