Progress
Results User’s Guide
for UNIX


Using Customized Help Messages

When users press HELP, Results calls a procedure called applhelp.p. Most applications have their own applhelp.p that contains help instructions for their own products. This is the source code for Results help:

/* applhelp.p - PROGRESS RESULTS applhelp.p */

DEFINE SHARED VARIABLE qbf-direct AS CHARACTER NO-UNDO.
DEFINE SHARED VARIABLE qbf-module AS CHARACTER NO-UNDO.

DEFINE VARIABLE qbf-c AS CHARACTER INITIAL ? NO-UNDO.

IF qbf-module = "f" THEN qbf-c = SEARCH("ft.r").
IF qbf-c <> ? THEN DO: /* FAST TRACK help */
  RUN VALUE(qbf-direct + "s-prefix.p") (qbf-c,OUTPUT qbf-c).
  RUN VALUE(qbf-c + "applhelp.p").
  RETURN.
END.

IF LENGTH(qbf-module) > 0 THEN DO: /* RESULTS help */
  RUN VALUE(qbf-direct + "s-help.p").
  RETURN.
END.

/* Put your own help routine here */ 

If you place this routine at the top of your application help, you enable online help to work correctly for Results as well as your application’s help system.

You must invoke the help supplied with Results when the qbf-module variable shown in the source code contains text. The "Determining the Originating Module" section in this chapter describes the qbf-module variable.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095