ALink

Creates Associative links (ALinks) that jump to target HTML files that contain the specified ALink names. 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="ALink [,menu|,dialog]">;
<PARAM  name="Item1"         value="<i>.chm file path</i>">;
<PARAM  name="Item2"         value="<i>ALink 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="DefaultTopic" 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 ALink 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.

DefaultTopic

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

Flags

Specifies how to behave if only one target is found or if 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 file that contains the target topics.

Item2

Specifies the text for one ALink name. This text must match an ALink name that has previously been inserted into one or more topics using the Compiler Information feature.

Subsequent ALink names are specified as Item3, Item4, etc.

Text

Specifies the link text. Optional.

Example

Note that in this example ALink targets will appear in the Topics Found dialog box because neither dialog nor menu is specified in the Command parameter value.

<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="ALink">
   <PARAM name="Button" value="Text:See Also">
   <PARAM name="Item1" value="c:\Help\MyFile.chm">
   <PARAM name="Item2" value="overview">
   <PARAM name="Item3" value="bibliography">
</OBJECT>

Sample ALink command

HTML Help ActiveX control overview topics

• Overview topic template
• Decision topic template
• Multi-step procedure topic template
• One-step procedure topic template
• Source-code example topic template

Remarks

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

Related topics

About Commands