Click to return to the HTML Help home page    
Commands     Close     HTML Help ActiveX Control...    
Web Workshop  |  DHTML, HTML & CSS  |  HTML Help

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


link to overview topic About commands
 


Back to topBack to top

Did you find this material useful? Gripes? Compliments? Suggestions for other articles? Write us!

© 1999 Microsoft Corporation. All rights reserved. Terms of use.