建立帮助文和打包发行.ppt
《建立帮助文和打包发行.ppt》由会员分享,可在线阅读,更多相关《建立帮助文和打包发行.ppt(66页珍藏版)》请在三一办公上搜索。
1、第12章 建立帮助文件和打包发行,12 建立帮助文件和打包发行,12.1制作帮助文件12.2 WinHelp函数12.3 在项目中添加上下文相关的F1帮助12.4 Whats this?帮助12.5 编译应用程序12.6 使用打包和展开向导12.7 安装和卸载应用程序小结,12.1制作帮助文件,12.1.1 创建帮助主题文件12.1.2 建立项目文件12.1.3 映射主题ID12.1.4 使用宏12.1.5 建立和添加目录文件12.1.6 使用全文搜索12.1.7 创建Help窗口12.1.8 编译和测试帮助文件12.1.9 使用HTML Help Workshop编译和测试帮助文件,12.1
2、制作帮助文件,创建帮助主题文件创建帮助主题是帮助文件中信息的基本单位。一个主题包括以下一个或几个部分。(1)信息内容:一般是文本,也可以是图片或多媒体。(2)跳转(hotspots):文本或图片,用户可以通过用鼠标点击跳到别的主题或者运行宏(macros)。(3)脚注:Help Workshop通过脚注来辨认主题的ID、标题、关键字、主题在浏览中的顺序、包含主题的文件,以及显示主题的窗口等内容。其中主题ID可以唯一地标识主题。,12.1制作帮助文件,主题存放在主题文件中:主题文件是.rtf格式,一个主题占单独一页。一个主题文件可以包含多个子主题,一个帮助文件可以包含多个主题文件。帮助主题文件是
3、.rtf格式,可以用Word编辑,通过添加不同脚注,设置字体风格,确定主题、跳转等。帮助主题文件,12.1制作帮助文件,一、添加合适的脚注主题ID是通过添加脚注#确定的。给一个主题加入ID的步骤如下:(1)在主题文件中,将光标移动到要加入ID的主题的开始的位置。(2)选择菜单“插入/脚注和尾注”,插入脚注,在自定义的文本框中键入字符“#”,如图12.1所示。(3)键入主题ID的名字作为脚注的文本。主题ID的命名规则:主题ID可以包含空格,但首尾空格不包括在内;不能使用保留字符#、=、+、*、%、!;长度不能超过255个字符;,12.1制作帮助文件,如果主题ID也用在MAP section中,首
4、字符不能是数字;为了使Help Workshop便于查错,建议主题ID以“IDH_”开头。,图12.1 添加脚注,12.1制作帮助文件,表12.1 脚注符号及含义,12.1制作帮助文件,二、创建主题的跳转(1)将光标移动到希望跳转到别的主题的文本或位图后面,键入目的主题ID。注意中间不要有空格。(2)给这些文本或位图增加:双下划线:如果希望显示另一主题。单下划线:如果希望使用弹出式链接。(3)键入的目的主题ID使用隐藏格式。,12.1制作帮助文件,建立项目文件创建一个新的项目文件时,从Help Workshop的File菜单中选择New,来显示New对话框。双击Help Project,在合适
5、的路径下键入项目文件的名称,并单击OK。图12.2显示了项目窗口。新创建的项目文件已包含了一个项目文件所必需的最小设置,但在可以编译之前,必须加入至少一个.rtf文件,其余的取决于Help文件的大小和复杂度。,12.1制作帮助文件,如图11-2所示,Help Workshop集成环境中提供了很多的菜单的命令按钮用来配置项目文件。点击“Files”按钮,可以弹出添加主题文件对话框,可以添加或删除用Word编辑好的主题文件。如何创建主题文件可参考上一节有内容。,图12.2 Help Project窗口,12.1制作帮助文件,映射主题ID在帮助文件中,可以以字符串的形式输入主题ID。例如,在帮助主题
6、的#脚注中输入IDH_Main解释缺省主题。在应用程序中,可以以数字形式输入主题ID。例如,可以为某个按钮或窗体的HelpContextID属性设置为1003,当进入WhatsThisMode时,点击按钮WinHelp将显示主题ID为1003的内容。使用Map可以将名字和数字之间建立联系。Help Workshop窗体中的“Map”按钮使程序可以映射帮助主题,单击Map按钮,如果要加入一个映射主题,单击Add,如果要包含一个C头文件,单击Include按钮。,12.1制作帮助文件,上下文相关的主题ID,前四个字符必须是IDH_。Help Workshop认为这些主题ID是程序要使用的。当编译时
7、,Help Workshop列出主题文件中所有没有映射到数值的主题ID,以及所有映射到数值却不是主题文件中的主题ID。使用IDH_命名规范可以帮助发现和解决创建上下文相关的帮助中的问题。,12.1制作帮助文件,使用宏 在Help Workshop窗口中,单击“Options”按钮,然后选择“Macros”选项卡,可以加入关键字和宏。宏在Help系统中实现特殊的任务。你可以在主题显示、用户单击按钮或用户单击链接时运行一个宏。WinHelp提供了一组宏,以用来控制和定制Help函数,例如Alink、Klink和About等。当创建帮助文件时,可以在以下一些场合创建帮助宏。(1)在项目文件中加入帮助
8、宏,任何时候只要用户在帮助文件或一种特定的窗口类型,WinHelp就会运行宏。(2)在项目文件中加入帮助宏,任何时候只要用户在帮助主题对话框中,从索引选项卡中选择一个关键字,WinHelp就会运行宏。,12.1制作帮助文件,(3)在主题脚注中加入帮助宏,当用户显示该主题时运行宏。(4)在目录文件中加入帮助宏,当用户双击相连的页面图标时运行宏。(5)配置菜单栏和按钮栏,当用户单击菜单选项或按钮时运行宏。(6)在主题中加入跳转,当用户单击跳转文本或位图时,运行宏。帮助宏的设计类似于标准C语言格式,但标准的帮助宏不支持变量和表达式赋值。如果标准的帮助宏不能满足最终目标,还可以使用DLL函数创建自己的
9、帮助宏。要为链接添加一个宏,需要在链接的隐藏文字的宏名前加上“!”脚注。例如,相关信息!Klink(API,WinHelp)。运行这个Klink宏,当用户单击相关信息时,会显示含有关键字API或WinHelp的主题清单。宏表达式有两个组成部分:宏名和后面括号中的参数。形如:MacroName(parameter1,parameter12,),12.1制作帮助文件,建立和添加目录文件 还可以将目录文件联系到帮助文件,方法是:单击Options按钮,选择Files选项卡,在Contents File文件框里,键入目录文件的名字。目录文件(.cnt)是一个ASCII文本文件。它提供帮助主题对话框的目
10、录选项卡的指示信息,并指示WinHelp在索引和搜索选项卡上显示特定的帮助文件的关键字。为了创建自己的目录表,必须在目录文件中填写以下各项:标题,主题和命令。,12.1制作帮助文件,创建一个新的目录文件的步骤如下:1在Help Workshop中,单击File菜单中的New项。2双击Help Contents。3在缺省文件名处,键入包含大部分主题的帮助文件的名称,出现如图12.3所示的界面。4在缺省标题处,键入文本,它将出现在帮助对话框的标题栏里。,12.1制作帮助文件,5单击Add Above或Add below加入要显示在目录选项卡上的标题和主题6如果要在索引选项卡中包含几个文件的关键字,
11、单击Index Files并给出要包含的文件名。,12.1制作帮助文件,对于每个主题可以通过按钮“Move Right”和“Move Left”将其挪动到合适的层次。只有当目录文件至少包含一个可以跳到用户计算机上的帮助文件的主题时,目录选项卡才会出现在帮助主题对话框中。当用户首次打开相连的帮助文件时,有效的跳转显示在目录文件中。,图12.3 目录文件编辑界面,12.1制作帮助文件,可以通过目录文件把几个帮助文件的关键字结合起来。步骤如下:1在Help Workshop中,打开目录文件。2单击索引文件按钮。3单击Add。4在帮助标题栏里,键入帮助文件的标题。当用户在搜索设定向导中选择自定义时,会
12、显示该标题。如果WinHelp在不同的帮助文件中发现相同标题时,它也会显示在主题搜索对话框中。5在帮助文件名一栏里,键入帮助文件名,它的关键字是要加入到索引中的。,12.1制作帮助文件,当运行Alink或Klink宏时,所有包含在索引中帮助文件被自动搜索。如果要使Alink和Klink跳转到别的帮助文件,则在打开目录文件后,单击链接文件按钮,然后单击Add,键入希望Alink或Klink宏运行时要链接到的帮助文件的名称。已经包括在索引文件对话框中的文件不必加入。如果要在主题对话框中增加一个选项卡,则在打开目录文件后单击Tab按钮,然后单击Add。在选项卡名称栏,键入希望选项卡上显示的名称,在D
13、LL文件名处,键入DLL文件的名称,它提供支持选项卡的对话框子程序。,12.1制作帮助文件,使用全文搜索WinHelp4.0提供了全文搜索机制(FTS),使用户可以在所有的帮助文件中搜索一个匹配。为了创建一个全文搜索机制,首先打开项目文件,单击Options按钮,单击FTS选项卡进行配置,这将会在编译时创建一个全文搜索文件(.fts)。,12.1制作帮助文件,创建Help窗口可以在Help Workshop中配置主题显示窗口的风格,这首先要点击项目窗口中的Windows按钮,在弹出的对话框中设置窗口的名称、位置、大小、按钮等内容,然后在编辑项目文件或目录文件时在合适的地方选择窗口类型。主题显示
14、时的窗口也可以在主题文件中由脚注“”规定,缺省情况下主题将在缺省类型的窗口显示。如果目录项不包含一个文件或规定窗口类型,当用户从目录选项卡中打开主题时,主题也将在缺省类型的窗口中显示。如果不设置缺省窗口,主题将在主帮助窗口中显示。设置的窗口类型必须在项目文件中定义。,12.1制作帮助文件,编译和测试帮助文件编译帮助文件是一个利用主题文件,图形和项目文件来创建帮助文件的过程。可以通过单击项目窗口中的“Save and Compile”按钮来编译帮助文件,它启动编译器。编译后,将会显示错误和警告。要测试新的帮助文件,需单击Help Workshop中的Run WinHelp按钮,然后单击View
15、Help File对话框中的View Help按钮。也可以在资源管理器中直接双击帮助文件。如果要同时编译多个帮助文件,可以创建一个后缀为.hmk的文本文件,在其中按编译顺序列出项目文件的全路径名,每行一个。编译时,只要在项目文件名处键入这个.hmk文件就可以了。单击“Help Workshop”中的“Test”菜单中的“Contents File”项,可以测试目录文件。“Help Workshop”检查目录文件的语法是否正确,然后跳转到每个主题。如果某个跳转不可行,它会给出错误信息。,12.1制作帮助文件,使用HTML Help Workshop编译和测试帮助文件在Visual Studio
16、6.0中,还包含了HTML Help Workshop,它的界面和Help Workshop差不多,区别在于它的主题文件是HTML格式,而不是RTF格式,所以,如果熟悉HTML语言编写规则,可以直接用文本编辑器制作主题文件,当然也可以使用FrongPage等方便的可视化页面制作工具。HTML Help Workshop还可以把Help Workshop环境下的帮助工程转换为HTML格式的帮助工程,这在新建工程的向导中提供。HTML Help Workshop编译出来的帮助文件后缀是chm,WinHelp函数可以识别。HTML Help Workshop还能反编译chm后缀的帮助文件.,12.2
17、 WinHelp函数,调用Windows API函数WinHelp可以直接激活一个帮助文件,这是老式的访问帮助文件的方法。要使用该函数,和其他的API一样,在应用程序中需要为其添加一个声明,如下所示:Option ExplicitPublic Declare Function WinHelp Lib user32 Alias WinHelpA(ByVal hwnd As Long,ByVal lpHelpFile As String,ByVal wCommand As Long,ByVal dwData As Long)As LongWinHelp函数启动WinHelp.exe并传递必要的数据
18、给帮助文件。,12.2 WinHelp函数,调用该函数需要窗体的句柄hwnd,WinHelp函数通过这个句柄知道哪个程序在请求帮助。lpHelpFile是WinHelp要显示的帮助文件的路径和文件名。如果要在特定的窗口显示帮助主题,应该在文件名后面加上“子窗口名”,这个特定的子窗口名应该是在帮助项目文件中定义过的。wCommand 参数是启动帮助时执行的命令编号,对于个别命令可能还需要添加另外的数据,它由参数dwData提供。例如,下面的调用将打开VISUAL BASIC6.0帮助文件,并显示目录窗口:WinHelp(hwnd,”HelpVISUAL BASIC6.0.hlp”,HELP_CO
19、NTENTS,0),12.2 WinHelp函数,在关闭应用程序窗口之前,程序必须调用WinHelp函数,wCommand 参数设置为HELP_QUIT。除非所有的程序都这样做了,否则WinHelp不会终止。如果使用HELP_CONTEXTPOPUP命令启动帮助,就不需用HELP_QUIT命令关闭帮助窗口。有关wCommand参数的可能值,以及相应的dwData参数的格式,请参考相关的联机帮助文件或使用手册。,12.3 在项目中添加上下文相关的F1帮助,在VISUAL BASIC应用程序添加帮助实际上是非常简单的。所要做的仅仅是为全局对象App设置属性HelpFile,并且,当然还要编写并编译
20、好帮助文件,使用户能够在按下F1键或从菜单中请求帮助时显示帮助。如果想为应用程序中的任何用户界面元素提供上下文有关的帮助主题,可以设置该元素的属性HelpContextID。帮助文件是hlp后缀还是编译好的HTML,本质上是相同的。App对象的HelpFile属性用于指定应用程序使用的帮助文件的文件名,它必须是有效的WinHelp(.hlp)或HTML帮助(.chm)文件。如果该文件不存在,则会产生错误。设置HelpFile属性可以在Project Properties对话框或者像下面的代码一样在窗体装载时设定:Private Sub Form_Load()App.HelpFile=App.P
21、ath&Visual Basic6.chmEnd Sub,12.3 在项目中添加上下文相关的F1帮助,全局对象Err也有一个HelpFile属性,使应用程序能够为错误消息指定不同的帮助文件。例如,如果有多个应用程序共享相同的错误消息,则可以将错误消息的帮助存入一个帮助文件中,这样就能够在每个应用程序中通过Err.Helpfile调用了。HelpContextID属性用于将用户界面元素(例如控件、窗体或菜单)与帮助文件中的某个主题链接起来,HelpContextID属性必须是与WinHelp(.hlp)或HTML(.chm)文件中的某个主题的ID匹配的长整数。例如,可以设置TextBox1的He
22、lpContextID属性为2000,当用户选定TextBox1并按下F1键时,VISUAL BASIC就会在由应用程序的HelpFile属性指定的帮助文件中查找标识为2000的主题。如果找到了相应的帮助主题,将打开“帮助”窗口并显示该主题;否则,将产生错误并显示帮助文件的缺省主题。,12.3 在项目中添加上下文相关的F1帮助,应当使用唯一的HelpContextID来匹配帮助文件中的每一个帮助主题。在某些情况下,如果某些对象共享一个通用的帮助主题,则可能需要为多个对象赋相同的HelpContextID。没有必要为窗体中的每一个控件设置HelpContextID属性。如果用户在HelpCont
23、extID为0(缺省值)的控件上按下F1键,VISUAL BASIC将会为该控件的容器查找有效的HelpContextID。如果有多个帮助主题,可能在输入HelpContextID之前确定一个编号计划会有所有用。最好是为应用程序中的每一个窗体或主要的元素赋予不同的编号范围,例如,第一个窗体用1000 1999,第二个窗体用2000 2999,依此类推。显示帮助主题不一定要求用户按了F1热键,可以用软方法激活帮助主题,就像用户按了F1键一样,但并不显式地调用WinHelp函数,如下所示为一个帮助命令按钮的Click过程,它实际上模拟用户按F1键:Private Sub cmdHelp_Click
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 建立 帮助 打包 发行
![提示](https://www.31ppt.com/images/bang_tan.gif)
链接地址:https://www.31ppt.com/p-6280558.html