CALL ai.hlp.open (mode, $file, $topic, $window, status)

CALL ai.hlp.open (mode, $file, $topic, $window, status)
 
Function

Open the specified HTML help file.

Input Parameters

mode Specify the type of file to open:
1 HTML help file with topic and window style
2 HTML help file with index name and window style
(HTML files should have a .CHM file extension)
3 Adobe Acrobat file with book name
(Acrobat files should have a .PDF file extension

$file Name of the help file on the NFS mounted drive. Do not include a path specification. The first time the user requests help, AdeptWindows will display a browse window allowing the user indicate the proper directory path.

$topic For mode = 1, specify the name of the hypertext marker in the .CHM file. A file specification is required for this mode.

For mode = 2, specify the string to index to.

For mode = 3, specify the name of the .PDF file to open.

$window Specify the window style to use when opening the HTML help system. Must be NULL ("") if not used. If NULL the help system will use its default window style. The value depends on the associated HTML file.

Output Parameters

status Returns 0 if no error, otherwise a standard AIM error code.

Details

This routine allows customizers to display their own HTML or Acrobat help files.

Ten different files may be open. If the help system can not find the file in the list, it will prompt the user to browse to find the help file, replacing the least recently used file in the list.