home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource1 / program2 / ahlp14.sda next >
Encoding:
Text File  |  1993-09-08  |  3.4 KB  |  63 lines
  1. AHELP 1.40  Advanced Help Library for Clipper   Registration $50
  2. PDNLANG SEP93 CA CLIPPER HELP LIBRARY DATABASE INDEX DBASE <ASP>
  3. FILES: AHLP14.SDN
  4.  
  5. Authors: Stan Gardner (Capella), Jim Hass (MicroFox) [ASAD] <ASP> {STAR}
  6.  
  7. This help system, for use with your Clipper applications, provides
  8. both context-sensitive and generalized help windows. Features included
  9. with version 1.4 of AHELP (shareware) are:
  10.  
  11. *  control whether help windows have no border, a single-line border, or
  12.    a double-line border.
  13. *  control whether the cross-bars drawn inside the help windows have no
  14.    line, a single line, or a double line.
  15. *  automatically determines the appropriate intersections.
  16. *  control what colors AHELP will use for the help window border, title,
  17.    content, and highlight bar in the help index window.
  18. *  control whether or not the end user has the ability to create or
  19.    modify help windows.
  20. *  control whether or not the help windows have drop shadows.
  21. *  automatically positions the help window immediately below the screen
  22.    position of the input variable (e.g., a GET variable) if the window
  23.    will fit there; otherwise, the window appears immediately above the
  24.    input variable.
  25. *  provides a help index; whenever any help window is on the screen,
  26.    the user may press F1 to see the help index.  The help index is
  27.    another window with a scrolling alphabetic listing of help subjects.
  28.    The user uses the cursor control keys to highlight the subject of
  29.    interest, and presses Enter to see the corresponding help window.
  30.    The user may also type the first letter of the subject to move the
  31.    highlight bar immediately to the first occurrence of that letter.
  32. *  is sensitive to the Clipper environment.  If the cursor is off when
  33.    help is invoked, it will be off when control returns to your
  34.    application.  Conversely, if the cursor is on when help is invoked,
  35.    it will be on when control returns to your application.  The same
  36.    principle applies to colors, function keys, insert status, work area,
  37.    and the status of SET CONSOLE, DELETED, ESCAPE, and SCOREBOARD.
  38. *  does not use any "wait state" commands (READ, WAIT, ACCEPT, INPUT,
  39.    MENU TO), to avoid conflicts with any pending GETs.  It uses the
  40.    INKEY() function for all keyboard input, with two exceptions: it
  41.    calls DBEDIT() for the help index window and MEMOEDIT() for
  42.    displaying/editing help text.
  43.  
  44. When the user presses the help key while your application is in any wait
  45. state, Clipper automatically calls AHELP with three parameters: the name
  46. of the procedure in control when the key was pressed, the line number
  47. that was executing, and the name of the wait state input variable. AHELP
  48. uses the first and third parameters to construct a "seek key".  It opens
  49. the help file and performs a seek for that key.
  50.  
  51. If the key is found, AHELP5 opens a help window and displays the help
  52. text. The window is opened as close as possible to the input variable
  53. screen position. If the key is not found, AHELP5 opens a smaller help
  54. window in the center of the screen and notifies the user that no help
  55. is available. Either window will show available options at the bottom
  56. of the window: Escape to cancel help, F1 to call up the help index, and
  57. F4 to edit or create the help display (if editing is enabled).
  58.  
  59. Hardware Requirements: IBM compatible computer, 512K RAM.
  60.  
  61. Other Requirements: Clipper Summer '87 or CA-Clipper version 5.
  62.  
  63.