符合Windows 98规范的帮助文件的开发[2]

[入库:2005年8月18日] [更新:2007年3月24日]

本文简介:选择自 ganman 的 blog

  (1)在hhctrl向导的第一步(见图7)的specify the command栏中选择“shortcut”。

  (2)在hhctrl向导的“shortcut”对话框(见图8)中输入该快捷方式要启动的程序名称(如notepad.exe)及参数。

  

  图8.hhctrl向导的“shortcut”对话框

  5.2.4 向html文件中插入相关主题(related topics)

  相关主题是出现在某个主题文件中包含与该主题文件相关的主题文件的链接的html help activex控件。插入相关主题的步骤如下:

  (1)在hhctrl向导的第一步(见图7)的“specify the command”栏中选择“related topics”。

  (2)在hhctrl向导的“related topics”对话框中输入相关的主题文件的标题和路径(见图9)。

  

  图9.hhctrl向导的“related topics”对话框

  5.2.5 向html文件中插入关键字链接(klinks)

  关键字链接(keyword links)简称klinks,它是在已经加入到帮助主题文件中的关键字的基础上建立的。 当用户在帮助文件中单击klinks按钮或链接时包含keyword(与该klink中的keyword相同)的主题文件的标题将列表显示。当在帮助主题文件中增加或减少关键字的时候,klinks也自动地更新。使用klink也能跳转到另外的帮助文件的主题文件。

  5.2.5.1 创建klinks

  创建klinks的步骤如下:

  (1)向html文件加入关键字

  ①打开html文件,并将光标定位在body部分需要加入关键字的地方。

  ②在edit菜单上单击“compiler information(编译信息)”,启动compiler information对话框(见图10),单击keywords选项卡。在keywords选项卡中单击“add”按钮,接着指定关键字;可以指定多个关键字,并用分号将它们分隔开。

  

  图10.编译信息对话框

  (2)向html文件插入关键字链接

  向html文件插入关键字链接实际上就是向html文件插入一个命令为“keyword search”的html help activex控件,其方法如5.2.1节所述,其中需要说明的步骤如下:

  ①在hhctrl向导的第一步(见图7)的“specify the command”栏中选择“keyword search”。

  ②在hhctrl向导的“keyword search”对话框中单击“add”按钮,输入已在compiler information对话框定义的关键字(见图11)。

  

  图11.hhctrl向导的“keyword search”对话框

  5.2.5.2 将klinks关键字包括在索引文件中

  在“chang project options”对话框的“files” 选项卡(见图3)中核选“include keywords from html files(包括html文件中的关键字)”框,klinks关键字将被包括在索引文件中。

  5.2.6 向html 文件插入联想链接(alinks)

  联想链接(associative links)简称alinks,它是在已经加入到帮助主题文件中的alink names的基础上建立的。当用户在帮助文件中单击alinks按钮或链接时包含alink name(与该alink中的alink name相同)的主题文件的标题将在一个对话框或弹出菜单中显示。与关键字不同的是帮助文件用户决看不到alink name。

  创建alinks的步骤除以下两点外与创建klinks的方法完全一致,有区别的两点是:

  (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标签如下:

  1 <object id=hhctrl 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 <param name="command" value="klink">

  8 <param name="button" value="text:klinks">

  9 <param name="item1" value="">

  10 <param name="item2" value="管理部">

  11 </object>

  这是一个典型的hhctrl向导所加入的标签(不包括左面的行号),根据插入html help activex控件时选择的命令不同其中第7行的“value”值有所不同。从第8行可以看出html help activex控件在html文件中缺省地以按钮的方式显示,要想以文字代替按钮,只要将“button”改成“text”就可以了,这时第8行的“value”值也从原来显示在按钮上变为作为单独的文字来显示html help activex控件,它是不带下划线的,要想改成带下划线的文字只需在第8行和第9行之间加入类似下面的语句:

  <param name="font" value="verdana,8,0x000800,underline">如果您在hhctrl向导中选择的不是以文字显示在按钮上,那么第8行的“value”值也要修改成“text:xxx”的形式。

  5.3 向html 文件中插入javascript(java脚本)

  5.3.1 用正文链接代替按钮显示html help activex控件

  请注意,本问题与5.2.7有所不同,5.2.7中显示html help activex控件的方式是带下划线的文字,而本问题却是以正文链接来显示html help activex控件,其实是在html文件中又加入了javascript,实现的方法是:在创建html help activex控件时的hhctrl向导的第二步(见图7)中选择“hidden(only used for scripting)[隐藏(仅为脚本使用)]”,创建好html help activex控件之后,在object标签的下面加入类似以下的标签:

  <a href="javascript:hhctrl1 .click()">klink text link</a>

  下面是一个典型的正文链接标签:

  <a href="sd-98-002.html">a text link </a>

  从以上两个标签的比较可以看出新加入的标签确实是一个正文链接(在word 97中叫超级链接),区别是用一个javascript语句代替了链接要跳转到的html文件。新加入标签中的“hhctrl1”是在hhctrl向导的第一步所填入的html help activex控件的“id name”。

  5.3.2 向html文件插入一个弹出式窗口(pop-up windows)

  弹出式窗口是一个弹出在帮助主题之上的窗口。它的样式能自动调整大小,以恰好容纳它里面所有的文字和图像。弹出式窗口一直保持在屏幕之上直到用户用鼠标单击其内部或外部的任何地方。该窗口的式样如图12所示:

  

  图12.一个弹出式窗口的例子

  要向html文件插入一个弹出式窗口,只需在html文件中加入类似于下面所列的语句:

  <a href=

  javascript:hhctrl.textpopup("this is how a pop-up window looks.","verdana,10",9,9,-1,-1)>here</a>

  可以看出,以上语句也是一个修改了的正文链接。其中,括号中的文字就是显示在弹出式窗口中的文字,您可以按该语句所示的格式修改成您需要的文字。

  5.4 将链接指向另外帮助文件中的主题文件

  将链接指向另外帮助文件中的主题文件的方法是将链接所指的帮助主题文件改成以下形式:*.chm::/*.htm。其中第一个*号代表另外的帮助文件的文件名,第二个*号表示第一个*号所表示的帮助文件中的帮助主题的文件名。

  6.创建搜索(search)

  帮助文件的search选项卡允许用户在帮助文件的所有主题文件中搜索与用户在search选项
 

本文关键:htmlhelp
  相关方案
Google
 

本站最佳浏览方式为 分辨率 1024x768 IE 6.0(或更高版本的 IE浏览器)

go top