如何编联机帮助?

normalnotebook 2003-05-26 11:28:30
如何在菜单中调用联机帮助?这个联机帮助怎样编写?
最好能给出样例?先谢过了!!!
...全文
149 3 打赏 收藏 转发到动态 举报
写回复
用AI写文章
3 条回复
切换为时间正序
请发表友善的回复…
发表回复
zhongyj 2003-05-26
  • 打赏
  • 举报
回复


若要实现“这是什么?”帮助

在设计模式下打开想启用“这是什么?”帮助的表单。


把表单的 WhatsThisHelp 属性设置为“真”(.T.)。


若要在表单标题中显示一个“这是什么?”帮助按钮,把表单的 WhatsThisButton 属性设置为“真”(.T.)。


若要把一个“这是什么?”帮助主题与该表单关联起来,把表单的 WhatsThisHelpID 属性设置为与帮助中主题相对应的 ID 编码。


若要把一个“这是什么?”帮助主题与表单上特定控件关联在一起,选择控件然后把它的 WhatsThisHelpID 属性设置为与 HTML 帮助文件中的主题相对应的 ID 编码。
编程实现帮助特性
对应用程序编程,这样用户就可以访问 HTML 帮助系统。虽然一个 HTML 帮助系统可能包含一个或多个独立的文件,但从用户的角度看来,帮助只是应用程序的一部分。

可以使用 SET HELP TO 及 SET TOPIC TO 命令编写 Visual FoxPro 应用程序使其使用图形或 .dbf 样式的帮助。SET HELP TO 指定了应用程序所用的自定义帮助。SET TOPIC TO 为自定义帮助中的主题设置识别关键字。

保留 F1
当用户在应用程序中按 F1 键时,Visual FoxPro 会显示一个“上下文相关帮助”主题。为了做到这一点,可在帮助表中为需要“上下文相关帮助”的主题指定一个帮助相关 ID,并把此值赋给表单或控件的 HelpContextID 属性。当表单或控件获得焦点并且用户按 F1 键时,Visual FoxPro 就会显示该主题。

注释 在默认情况下 F1 键是可用作上下文相关帮助激活键的。因为这是一个公认的激活上下文帮助的标准,因此并不推荐您重定义这个键。

在表单中包含“帮助”按钮
如果在表单中添加“帮助”按钮,用户可以更方便地访问帮助信息。如果用户是个新手,那么更应该考虑添加一个“帮助”按钮。

若要设置上下文相关帮助并添加一个“帮助”按钮

在表单的 Init 事件中,将表单中所有对象的 HelpContextID 属性都设置为该帮助主题的 ID 值。例如,如果该值为 7,可用如下命令:
THIS.SetAll("HelpContextID", 7)

在表单中添加一个命令按钮。


把命令按钮的 Caption 属性设置为“帮助”。


在命令按钮的 Click 事件中,添加下面的命令:
HELP ID THIS.HelpContextID

提示 可把“帮助”按钮保存为一个类,这样就可以方便地把它添加到任何表单中。有关把对象保存成类的详细内容,请参阅第九章“创建表单”。

发布已编译的 HTML 帮助系统
除了为您的 HTML 帮助系统创建 .chm 文件之外,您还可以使用一个免费发布的安装程序—Hhupd.exe,安装或注册下列 HTML 帮助的运行时刻组件。您的用户电脑中必须安装 Internet Explorer 或者 Internet Explorer 运行时刻引擎。

组件名称 说明
Hhctrl.ocx HTML Help ActiveX 控件
Itss.dll 处理编译过的 HTML 的动态链接库
Itircl.dll 完整文字查找动态链接库
Hh.exe HTML 帮助查看器


这个安装程序可以在 Redist 文件夹中找到,Redist 文件夹位于安装 HTML Help Workshop 的文件夹中。此安装程序可以从其他安装程序中调用,并且可以被设置为“静态”模式运行,这样就避免了对您已经创建完成的安装程序的干扰。如果需要完整的命令行选项列表,运行 Hhupd.exe/?。

WinHelp 4.0
使用 Microsoft Help Workshop,此软件在 Visual FoxPro 的前一版本中提供,创建图形样式 Windows 帮助文件。Help Workshop 中包含了“帮助指南”,“帮助指南”(Hcw.hlp)是一个图形样式的帮助文件,包含了创建一个强大的帮助系统所需的许多信息。

选择帮助特性
WinHelp 系统可具有下列部分或所有特征:

一个目录页面,提供帮助系统中主题的层次结构的视图。


一个基于您所提供的关键字的索引,引导用户到特定内容。


全文本查找功能,允许用户通过特定字及短语在帮助中查找信息。


具有多种字体、字体大小和颜色的文本。


图形,包括多种分辨率的位图。


宏,扩展帮助系统的功能,使操作自动化。


热点,这是一个鼠标敏感区域,可让用户跳转到相关的主题;弹出式窗口用于显示附加文本;添加到帮助系统的宏命令。


段式超图形,即具有一个或多个热点的图形。


辅助窗口。


可定制的菜单。


Windows 图元文件格式的图形


.DLL 文件
计划对联机帮助的访问
除了创建一个包含有用信息的 WinHelp 文件之外,还需要向应用程序用户提供访问帮助的途径。有三种方法可以访问帮助:

帮助菜单 — 显示在应用程序主菜单栏上的一个菜单。


上下文相关帮助 — 当选定某个对象、控件或菜单选项并按 F1 键(或您指定的其他键)时显示的帮助。


“这是什么?”帮助 — 当用户寻求关于特定对象或控件的帮助时出现的简单弹出式提示。
计划一个帮助菜单
一个典型的帮助菜单包含可以访问帮助主题的命令。WinHelp 4.0 的访问特性是“帮助查找器”窗口,它是一个可以按内容、索引以及全文本方式查找的单个对话框。

“帮助查找器”窗口



我们强烈建议您的帮助菜单上应该有一个打开“帮助查找器”窗口的命令。除此之外,您可以在帮助菜单上放置附加命令来提供系统信息或者应用程序的版权及版本号信息。

使用带“HELP FINDER”参数的 WinHelp 函数能够以编程方式调用“帮助查找器”窗口。有关的详细信息,请参阅本章稍后的“使用 WinHelp 函数”以及“帮助指南”中的 WinHelp 主题。

添加帮助的上下文相关性
“上下文相关帮助”允许用户随时方便地访问与他们在应用程序中所做所见相关的帮助主题。例如,如果用户正在查看一个数据输入表单,“上下文相关帮助”能够提供与那个数据输入表单相关的帮助主题。

您自己决定应用程序中实施的“上下文相关帮助”的详细层次。例如,您可以为一个表单关联一个上下文相关帮助主题,或者您可以为表单上每一个控件和字段关联一个更详细的帮助主题。

按 F1 键是访问“上下文相关帮助”的最常用的方法,但是您也可以使用 ON KEY LABEL 指定任意键来激活“上下文相关帮助”。

在“表单”上使用“上下文相关 WinHelp”



若要实施“上下文相关帮助”,必须为您的应用程序指定帮助,然后把特定的帮助主题与应用程序中不同的对象关联起来。

若要添加“上下文相关帮助”

为应用程序指定一个帮助。


为希望提供“上下文相关帮助”的每一个对象指定一个帮助主题。
指定一个帮助文件
通过在代码中包含 SET HELP TO file 命令(其中 file 是帮助文件的名字),可以决定应用程序能访问哪些帮助文件。例如,如果帮助文件名为 Myhelp.hlp,您可以使用下面的命令:

SET HELP TO Myhelp.hlp

这个命令一般包含在应用程序主程序的设置代码中。

指定帮助主题
应用程序中的特定对象指定一个帮助主题。

若要向一个对象指定一个帮助主题

在“设计”状态下打开想为之指定“上下文相关帮助”的对象,例如一个表单、控件或工具栏。


查看该对象的属性。


把 HelpContextID 属性设置为代表帮助文件中特定主题的编号。
有关把帮助主题映象为上下文 ID 编码的详细内容,请参阅“帮助指南”。

注释 若要向菜单标题或菜单命令指定帮助标题,必须在与菜单标题或菜单命令相关联的过程中包含 SET TOPIC TO 命令。
zhongyj 2003-05-26
  • 打赏
  • 举报
回复
通过添加图形方式“帮助”文件(HTML 形式或 WinHelp 帮助),可对应用程序进行一些专业级的修饰。图形方式的帮助中可以包含图形和经过格式编排的文本,而 .DBF 样式帮助不包含图形,只有单一字体的文本。有关创建 .dbf 样式帮助的详细内容,请参阅第二十四章“创建 .DBF 样式帮助”。

注释 Microsoft Visual Studio 6.0 包含有创建 HTML 帮助文件的 Microsoft HTML Help Workshop(Hhw.exe)。不包含创建 WinHelp 文件的 Microsoft Help Workshop 4.0(Hcw.exe)。上一版的 Microsoft Visual FoxPro 包含 Microsoft Help Workshop 4.0。

WinHelp 4.0
HTML 帮助
HTML 帮助提供了 Winhelp 的许多特性的同时,并增加了以下特性:

支持 HTML。


支持 ActiveX、Java和书写脚本(Javascript 和 Microsoft Visual Basic Script)等特性。


支持 HTML 的图象格式(.jpg 、.gif 、.png)。


提供从“帮助”主题中跳转到 Internet 的站点的功能。


提供查看“帮助”主题的 HTML 代码的功能。
HTML 帮助由 Microsoft HTML Help Workshop 创建,此软件包含在 Visual Studio 中并独立于 Visual FoxPro。HTML Help Workshop 提供一个完整的HTML 帮助创作系统,并且包含有向后兼容的功能,此功能可以很方便地从已有的 Winhelp 项目中创建 HTML 帮助文件。如果要创建用于您自己的应用程序的 HTML 帮助文件,请查阅 HTML Help Workshop 的联机帮助。

在 ...\Samples\Vfp98\Solution\Help 目录中包含一个 HTML 帮助项目的示例,此示例是 Solutions 示例的一部分。HTML 帮助示例包含以下文件:

文件 说明
Solution.chm 已编译的帮助文件。
Solution.hhp 项目文件 - 一个文本文件,此文件将所有构成帮助项目的元素以及包含有编译后的帮助文件的显示方式的信息组织在一起。
Solution.hhk 索引文件 - 包含索引条目(关键字)。
Solution.hhc 内容文件表。
Solution.ali 用于支持上下文相关帮助功能的别名文件。将 Product ID 映象为帮助主题。
Solution.hh 用于支持上下文相关帮助功能的头文件。包括 Product ID。
Solution.chi 当您希望访问仍然留在 CD-ROM 上的 .chm 文件时需要使用的索引文件,这种情形和 MSDN Library的情形相同。为了快速地访问帮助文件,.chi 文件允许将一定的定位信息安装在硬盘上,而将主要的内容留在 CD-ROM 上。.chi 文件不能在无 CD-ROM 的情况下使用。当没有使用 .chi 文件时,所有在 .chi 文件中的信息保留在 .chm 文件中。
MSDN_ie3.css 级联式样式表。
MSDN_ie4.css 级联式样式表。
FileName.htm 源内容文件。
FileName.gif 源图象文件。


计划对联机帮助的访问
除了创建一个包含有用信息的 HTML帮助文件之外,还需要向应用程序用户提供访问帮助的途径。有三种方法可以访问帮助:

帮助菜单 — 显示在应用程序主菜单栏上的一个菜单。


上下文相关帮助 — 当选定某个对象、控件或菜单选项并按 F1 键(或您指定的其他键)时显示的帮助。


“这是什么?”帮助 — 当用户寻求关于特定对象或控件的帮助时出现的帮助信息。
实现 HTML 帮助与实现 WinHelp 很相似。以下的章节将介绍如何实现应用程序的 HTML 帮助。

计划一个帮助菜单
一个典型的帮助菜单包含可以访问帮助系统的命令。我们强烈建议您的帮助菜单上应该有一个打开HTML 帮助系统的命令。除此之外,您可以在帮助菜单上放置附加命令来提供系统信息或者应用程序的版权及版本号信息等。

添加上下文的相关性
“上下文相关帮助”允许用户随时方便地访问与他们在应用程序中所做所见相关的帮助主题。例如,如果用户正在查看一个数据输入表单,“上下文相关帮助”能够提供与那个数据输入表单相关的帮助主题。

您自己决定应用程序中实施的“上下文相关帮助”的详细层次。例如,您可以为一个表单关联一个上下文相关帮助主题,或者您可以为表单上每一个控件和字段关联一个更详细的帮助主题。

按 F1 键是访问“上下文相关帮助”的最常用的方法,但是您也可以使用 ON KEY LABEL 指定任意键来激活“上下文相关帮助”。

在“表单”上使用“上下文相关帮助”

若要实施“上下文相关帮助”,必须为您的应用程序指定帮助,然后把特定的帮助主题与应用程序中不同的对象关联起来。

若要添加“上下文相关帮助”

为应用程序指定一个帮助。


为希望提供“上下文相关帮助”的每一个对象指定一个帮助主题。
指定一个帮助文件
通过在代码中包含 SET HELP TO file 命令(其中 file 是帮助文件的名字),可以决定应用程序能访问哪些帮助文件。例如,如果帮助文件名为 Myhelp.chm,您可以使用下面的命令:

SET HELP TO Myhelp.chm

这个命令一般包含在应用程序主程序的设置代码中。

指定帮助主题
可以向 Visual FoxPro 应用程序中的特定对象指定一个帮助主题。

若要向一个对象指定一个帮助主题

在“设计”状态下打开想为之指定“上下文相关帮助”的对象,例如一个表单、控件或工具栏。


查看该对象的属性。


把 HelpContextID 属性设置为代表 HTML 帮助文件中特定主题的编号。
有关把 HTML 帮助主题映射为上下文 ID 编号的详细内容,请查阅 HTML Help Workshop 的联机帮助。

注释 若要向菜单标题或菜单命令指定帮助标题,必须在与菜单标题或菜单命令相关联的过程中包含 SET TOPIC TO 命令。

实现“这是什么?”帮助
“这是什么?”帮助类似于上下文相关帮助,因为它提供对当前具有焦点的特定对象或控件的帮助。

对于 WinHelp,帮助并不激活帮助应用程序然后在默认大小的“帮助”窗口中显示帮助主题,而是在一个弹出式小窗口显示帮助主题,然后用户单击屏幕任意位置时该窗口消失。“这是什么?”帮助在提供简单提示型描述或特定控件定义时很有用。

与 WinHelp 不同,HTML 的“这是什么?”帮助显示在完全为默认大小的帮助窗口中。

要把“这是什么?”帮助与特定表单、表单控件或工具栏关联起来,把它们的 WhatsThisHelpID 属性设置为代表帮助特定主题的编号。

使用下列属性和方法程序来实现“这是什么?”帮助:

属性 说明
WhatsThisHelp 设置表单的该属性为真(.T.),可以启用表单以及表单上任意控件的“这是什么?”帮助。
WhatsThisButton 如果希望表单的标题栏显示一个“这是什么?”按钮,设置属性为真(.T.)。
WhatsThisHelpID 对一个表单、控件或工具栏,把该属性设置为对应于 HTML 帮助文件中某个主题的 ID 编码。
WhatsThisMode 使用这个方法程序可以显示“这是什么?”帮助,问号代表鼠标指针然后启动“这是什么?”帮助模式。单击一个对象将显示该对象 WhatsThisHelpID 属性指定的帮助主题。
zhongyj 2003-05-26
  • 打赏
  • 举报
回复
set help 命令
激活或废止 Visual FoxPro 联机帮助或指定的帮助文件。

语法

SET HELP ON | OFF
— 或者 —
SET HELP TO [FileName]

参数
ON

(默认值)当按下 F1 键或在命令窗口中执行 HELP 命令时,显示帮助窗口。

OFF

使 Visual FoxPro联机帮助不可用。

TO [FileName]

指定当按 F1 键或发出 HELP 时显示的帮助文件。可以指定一个 .Dbf 型帮助文件、一个 Winhelp (.Hlp) 文件,或一个 HTML (.Chm) 帮助文件。

如果执行不包含文件名的 SET HELP TO 命令,Visual FoxPro 会搜索 MSDN帮助文件 Msdnvs98.col。在 Visual FoxPro 6.0 中,使用 SET HELP TO 命令和一个帮助文件名,不关闭任何已打开的帮助文件。

说明

在 Visual FoxPro 中使用 SET HELP,可在用户应用程序中提供一种可编程的联机帮助文件,或在不同的帮助文件之间进行切换。

如果在安装 Visual FoxPro 时安装了 MSDN (Microsoft Developer's Network),则默认的帮助文件是 MSDN 帮助文件 Msdnvs98.col。

如果完全安装了 MSDN (Microsoft Developer抯 Network) 库,或者在定制安装 MSDN 库时指定安装 Visual FoxPro 文档,则安装 Visual FoxPro 帮助文件 Foxhelp.chm。

如果不安装 MSDN 库,则不安装任何帮助文件。

也可以使用“选项”对话框“文件位置”文件夹的“帮助文件”选项,交互地指定一个帮助文件。

2,749

社区成员

发帖
与我相关
我的任务
社区描述
VFP,是Microsoft公司推出的数据库开发软件,用它来开发数据库,既简单又方便。
社区管理员
  • VFP社区
加入社区
  • 近7日
  • 近30日
  • 至今
社区公告
暂无公告

试试用AI创作助手写篇文章吧