Share via

KLink

  • Article

Creates Keyword links (KLinks) that jump to target HTML files that contain the specified keyword(s). The list of target topics appears on a pop-up menu or in a dialog box.

This command can be used only with a compiled help (.chm) file.

Syntax

<PARAM  name="Command"       value="KLink [,menu|,dialog]">
<PARAM  name="Item1"         value="<i>.chm file path</i>">
<PARAM  name="Item2"         value="<i>keyword text</i>">
[<PARAM name="Button"        value="[Text: <i>Button text</i>|Bitmap: <i>Bitmap file path</i>|Icon:<i>Icon file path</i>]">]
[<PARAM name="Default Topic" value="<i>File name or HTTP URL</i>">]
[<PARAM name="Font"          value="<i>Facename[, point size[, charset[, color[, PLAIN BOLD ITALIC UNDERLINE]]]]</i>">]
[<PARAM name="Flags"         value=",,1">]
[<PARAM name="Flags"         value="1">]
[<PARAM name="Frame"         value="<i>Frame Name</i>">]
[<PARAM name="Text"          value="Text: <i>Link text</i>">]

Properties

Button

Specifies the button style. Optional.

Command

Calls the KLink command and specifies whether to display target topics on a pop-up menu or in a dialog box.

If you do not specify a display option, a dialog box appears by default.

To specify the Topics Found dialog box, type dialog.

To specify a pop-up menu, type menu.

Default Topic

Specifies the topic to navigate to if the look up fails. Optional.

Flags

Specifies how the command will behave if only one target is found or the target is unavailable.

Font

Specifies the font attributes. Optional.

Frame

Specifies the frame in which to display the selected topic. Optional.

Item1

Specifies the compiled help (.chm) file that contains the target topics.

Item2

Specifies a keyword. This text must match a keyword that has previously been inserted into one or more topics using the Compiler Information command.

Subsequent keywords are specified as Item3, Item4, etc.

Text

Specifies the link text. Optional.

Example

Note that KLink targets will appear on a pop-up menu in this example because menu is specified in the Command parameter.

<OBJECT
   id=MyControl
   type="application/x-oleobject"
   classid="clsid:52a2aaae-085d-4187-97ea-8c30db990436"
   codebase="Hhctrl.ocx#Version=5,02,3790,1194"
   width=100
   height=100
>
   <PARAM name="Command" value="KLink, menu">
   <PARAM name="Button" value="Text:Animal Diets">
   <PARAM name="Item1" value="animals.chm">
   <PARAM name="Item2" value="omnivore">
   <PARAM name="Item3" value="carnivore">
</OBJECT>

Remarks

  • The Button parameter is omitted when this command is invoked by a script.
  • To add keywords to a target HTML file, use the Compiler Information command, which is available on the Edit menu of HTML Help Workshop.

About Commands