ALink Command

Microsoft Corporation

Updated June 10, 1999

Purpose

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=".chm file path">
<PARAM  name="Item2"         value="ALink text">
[<PARAM name="Button"        value="[Text: Button text|Bitmap:Bitmap file path|Icon:Icon file path]">]
[<PARAM name="Default Topic" value="File name or HTTP URL">]
[<PARAM name="Font"          value="Facename[, point size[, charset[, color[, PLAIN BOLD ITALIC UNDERLINE]]]]">]
[<PARAM name="Flags"         value=",,1">]
[<PARAM name="Flags"         value="1">]
[<PARAM name="Frame"         value="Frame Name">]
[<PARAM name="Text"          value="Text: Link text">]

Property	Description
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.
Default Topic	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:adb880a6-d8ff-11cf-9377-00aa003b7a11"


  codebase="HHCTRL.ocx#Version=4,72,8252,0"


  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>

Comments

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.

	About commands