home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / MISC / TPCMEN.ZIP / TPCMENU.DOC < prev    next >
Encoding:
Text File  |  1991-06-06  |  6.4 KB  |  138 lines
  1.               COPYRIGHT (C) 1989, STEVE STAMM TPC Technologies
  2.              ALL RIGHTS RESERVED - FOR INFO CALL (615) 984-9029
  3.  
  4. DISCLAIMER
  5. ----------
  6. I have done everything that I know of to make all TPC utilities safe and
  7. friendly. However, I make no warranty of any kind.  If you use this product
  8. you do so at your own risk.  I will not be held responsible for any loss or
  9. damage resulting from its use.  By using this product you are agreeing to
  10. these terms.
  11.  
  12. PURPOSE
  13. -------
  14. The purpose for TPCMENU is to allow the programmer to easily create
  15. Lightbar Menus.  This version contains code to allow for the use of a
  16. mouse.  The mouse is automatically activated if the mouse driver is
  17. available.
  18.  
  19.  
  20. SYNTAX
  21. ------
  22. LOAD TPCMENU
  23. MEMVAR = CHR(CHOICE) + CHR(VERT_SPACE+1) + CHR(ROW+1)+;
  24.          CHR(COLLUM+1) + CHR(ROWS) + CHR(COLLUMS)+;
  25.          CHR(TOTAL) + CHR(HORZ_SPACE) + CHR(LB_WIDTH)+;
  26.          CHR(BACKGR) + CHR(BAR_COLOR) + OTHER_KEY + ;
  27.          SPACE(LB_WIDTH)
  28.  
  29. CALL TPCMENU WITH MEMVAR
  30.  
  31. PARAMETERS: 1 - CHOICE                  && First CHOICE to be highlighted
  32.             2 - VERTICAL SPACE          && Number of lines between rows
  33.             3 - STARTING ROW            && Topmost ROW of the menu
  34.             4 - STARTING COLLUMN        && Leftmost collum of the menu
  35.             5 - TOTAL ROWS              && Total number of rows
  36.             6 - TOTAL COLLUMNS          && Total number of columns
  37.             7 - TOTAL NUMBER OF CHOICES && Total number of menu choices
  38.             8 - HORIZONTAL SPACE        && Number of columns between bars
  39.             9 - LIGHTBAR WIDTH          && Width of the litebar
  40.            10 - BACKGROUND COLOR        && Numeric value for the screen color
  41.            11 - LIGHTBAR COLOR          && Numeric value for the bar color
  42.            12 - OTHER_KEY               && List of return keys (bounded by
  43.                                         && asterisks)
  44.                                         && Ex: other_key = "*"+chr(59)+"*"
  45.  
  46. COLORS
  47. ------
  48.  
  49. -------------------------------------------------------------------
  50. |              |                   Background                     |
  51. -------------------------------------------------------------------
  52. | Foreground   |  Black Blue Green Cyan  Red  Magenta Brown  Grey |
  53. -------------------------------------------------------------------
  54. | Black        |    0    16    32   48    64    80      96   112  |
  55. | Blue         |    1    17    33   49    65    81      97   113  |
  56. | Green        |    2    18    34   50    66    82      98   114  |
  57. | Cyan         |    3    19    35   51    67    83      99   115  |
  58. | Red          |    4    20    36   52    68    84     100   116  |
  59. | Magenta      |    5    21    37   53    69    85     101   117  |
  60. | Brown        |    6    22    38   54    70    86     102   118  |
  61. | Grey         |    7    23    39   55    71    87     103   119  |
  62. | Br Black     |    8    24    40   56    72    88     104   120  |
  63. | Br Blue      |    9    25    41   57    73    89     105   121  |
  64. | Br Green     |   10    26    42   58    74    90     106   122  |
  65. | Br Cyan      |   11    27    43   59    75    91     107   123  |
  66. | Br Red       |   12    28    44   60    76    92     108   124  |
  67. | Br Magenta   |   13    29    45   61    77    93     109   125  |
  68. | Br Brown     |   14    30    46   62    78    94     110   126  |
  69. | Br Grey      |   15    31    47   63    79    95     111   127  |
  70. -------------------------------------------------------------------
  71.  
  72. If you have turned "Blink" off using TPCBlInt.BIN then you can use
  73. the following combinations.  If you have not set "Blink" off, then
  74. using these combinations will result in Blinking or flashing colors.
  75. -------------------------------------------------------------------
  76. |              |                   Background                     |
  77. -------------------------------------------------------------------
  78. |              |    Br   Br    Br   Br    Br    Br      Br    Br  |
  79. | Foreground   |  Black Blue Green Cyan  Red  Magenta Brown  Grey |
  80. -------------------------------------------------------------------
  81. | Black        |   128  144   160   176  192    208    224   240  |
  82. | Blue         |   129  145   161   177  193    209    225   241  |
  83. | Green        |   130  146   162   178  194    210    226   242  |
  84. | Cyan         |   131  147   163   179  195    211    227   243  |
  85. | Red          |   132  148   164   180  196    212    228   244  |
  86. | Magenta      |   133  149   165   181  197    213    229   245  |
  87. | Brown        |   134  150   166   182  198    214    230   246  |
  88. | Grey         |   135  151   167   183  199    215    231   247  |
  89. | Br Black     |   136  152   168   184  200    216    232   248  |
  90. | Br Blue      |   137  153   169   185  201    217    233   249  |
  91. | Br Green     |   138  154   170   186  202    218    234   250  |
  92. | Br Cyan      |   139  155   171   187  203    219    235   251  |
  93. | Br Red       |   140  156   172   188  204    220    236   252  |
  94. | Br Magenta   |   141  157   173   189  205    221    237   253  |
  95. | Br Brown     |   142  158   174   190  206    222    238   254  |
  96. | Br Grey      |   143  159   175   191  207    223    239   255  |
  97. -------------------------------------------------------------------
  98.  
  99. NOTE
  100. ----
  101. TPCMENU RETURNS VALUES AS FOLLOWS:
  102.         * --- CHOICE = OPTION SELECTED
  103.         CHOICE= ASC(SUBSTR(MEMNAR,1,1))
  104.         * --- kEY PRESSED TO RETURN
  105.         KEY   = ASC(SUBSTR(MEMVAR,2,1))
  106.         * --- WHAT WAS UNDER THE BAR
  107.         UNDER = RTRIM(SUBSTR(MEMVAR,3,LB_WIDTH))7
  108.         * --- W A R N I N G !!! -----------------
  109.         * Be SURE that your memvar is long enough to accept the return
  110.         * params TPCMENU returns what was under the lightbar and will
  111.         * corrupt other memvars if the return var is not long enough.
  112.  
  113. Because of the long parameter list and having to parse out the returned
  114. string the program LBAR.PRG has been included.  See the demonstration
  115. program for examples of its use.
  116.  
  117. REGISTRATION
  118. ------------
  119. This utility is marketed using the SHAREWARE marketing concept.
  120. The idea is simple.  If you use it pay for it.
  121.  
  122. The fee for registering TPCMENU.BIN is $25
  123. For registration of all TPC utilities the fee is $50
  124.  
  125. For a list of all the TPC utilities send a Self Addressed Stamped
  126. Envelope.
  127.  
  128. Send all enquiries and registration fees to:
  129.  
  130. Steve Stamm
  131. TPC Technologies
  132. P.O. 9634
  133. Knoxville, Tenn. 37940
  134.  
  135. Thanks for your support!
  136.  
  137. Steve Stamm
  138.