第12章节建立帮助文和打包发行.ppt

第12章 建立帮助文件和打包发行 12 建立帮助文件和打包发行 12.1制作帮助文件 12.2 WinHelp函数 12.3 在项目中添加上下文相关的F1帮助 12.4 What’s this?帮助 12.5 编译应用程序 12.6 使用打包和展开向导 12.7 安装和卸载应用程序 小结 12.1制作帮助文件 12.1.1 创建帮助主题文件 12.1.2 建立项目文件 12.1.3 映射主题ID 12.1.4 使用宏 12.1.5 建立和添加目录文件 12.1.6 使用全文搜索 12.1.7 创建Help窗口 12.1.8 编译和测试帮助文件 12.1.9 使用HTML Help Workshop编译和测试帮助文件 12.1制作帮助文件 创建帮助主题文件 创建帮助主题是帮助文件中信息的基本单位。一个主题包括以下一个或几个部分。 （1）信息内容：一般是文本，也可以是图片或多媒体。 （2）跳转（hotspots）：文本或图片，用户可以通过用鼠标点击跳到别的主题或者运行宏（macros）。 （3）脚注：Help Workshop通过脚注来辨认主题的ID、标题、关键字、主题在浏览中的顺序、包含主题的文件，以及显示主题的窗口等内容。其中主题ID可以唯一地标识主题。 12.1制作帮助文件 主题存放在主题文件中：主题文件是.rtf格式，一个主题占单独一页。一个主题文件可以包含多个子主题，一个帮助文件可以包含多个主题文件。 帮助主题文件是.rtf格式，可以用Word编辑，通过添加不同脚注，设置字体风格，确定主题、跳转等。帮助主题文件 12.1制作帮助文件 一、添加合适的脚注 主题ID是通过添加脚注#确定的。给一个主题加入ID的步骤如下： （1） 在主题文件中，将光标移动到要加入ID的主题的开始的位置。 （2）选择菜单“插入/脚注和尾注”，插入脚注，在自定义的文本框中键入字符“#”，如图12.1所示。 （3）键入主题ID的名字作为脚注的文本。主题ID的命名规则： ①主题ID可以包含空格，但首尾空格不包括在内； ②不能使用保留字符#、=、+、@、*、%、!； ③长度不能超过255个字符； 12.1制作帮助文件 ④如果主题ID也用在[MAP] section中，首字符不能是数字； ⑤为了使Help Workshop便于查错，建议主题ID以“IDH_”开头。 12.1制作帮助文件 12.1制作帮助文件 二、创建主题的跳转 （1）将光标移动到希望跳转到别的主题的文本或位图后面，键入目的主题ID。注意中间不要有空格。 （2）给这些文本或位图增加： 双下划线：如果希望显示另一主题。 单下划线：如果希望使用弹出式链接。 （3）键入的目的主题ID使用隐藏格式。 12.1制作帮助文件 建立项目文件 创建一个新的项目文件时，从Help Workshop的File菜单中选择New，来显示New对话框。双击Help Project，在合适的路径下键入项目文件的名称，并单击OK。图12.2显示了项目窗口。新创建的项目文件已包含了一个项目文件所必需的最小设置，但在可以编译之前，必须加入至少一个.rtf文件，其余的取决于Help文件的大小和复杂度。 12.1制作帮助文件 如图11-2所示，Help Workshop集成环境中提供了很多的菜单的命令按钮用来配置项目文件。点击“Files”按钮，可以弹出添加主题文件对话框，可以添加或删除用Word编辑好的主题文件。如何创建主题文件可参考上一节有内容。 12.1制作帮助文件 映射主题ID 在帮助文件中，可以以字符串的形式输入主题ID。例如，在帮助主题的#脚注中输入IDH_Main解释缺省主题。在应用程序中，可以以数字形式输入主题ID。例如，可以为某个按钮或窗体的HelpContextID属性设置为1003，当进入WhatsThisMode时，点击按钮WinHelp将显示主题ID为1003的内容。使用Map可以将名字和数字之间建立联系。 Help Workshop窗体中的“Map”按钮使程序可以映射帮助主题，单击Map按钮，如果要加入一个映射主题，单击Add，如果要包含一个C头文件，单击Include按钮。 12.1制作帮助文件 上下文相关的主题ID，前四个字符必须是IDH_。Help Workshop认为这些主题ID是程序要使用的。当编译时，Help Workshop列出主题文件中所有没有映射到数值的主题ID，以及所有映射到数值却不是主题文件中的主题ID。使用IDH_命名规范可以帮助发现和解决创建上下文相关的帮助中的问题。 12.1制作帮助文件 使用宏 在Help Workshop窗口中，单击“Options”按钮，然后选择“Macros”选项卡，可以加入关键字和宏。 宏在Help系统中实现特殊的任务。你可以在