home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 2 / ctrom_ii_b.zip / ctrom_ii_b / PROGRAM / FOXPRO / VLIST110 / README.1ST next >
Text File  |  1992-10-02  |  8KB  |  153 lines
  1.                    Virtual List System library (VLIST)
  2. =============================================================================
  3.  
  4.   VLIST is a free product BUT donations are accepted so that I have
  5.   motivation to continue developing products such as these.  This is
  6.   therefore similar to ShareWare.  Hopefully the time saved by using
  7.   this product is worth a donation <g>...  The old ShareWare version
  8.   had a registration fee of $45.00.
  9.  
  10.       Jayson R. Minard
  11.       P.O. Box 1306
  12.       Westminster, CO 80030-1306
  13.  
  14.   You will also notice that full FORCE source code is included with this
  15.   release.
  16.  
  17.   JMAKE or Borland's make utility can be used to compile the libraries.  You
  18.   will need a librarian manager and an assembler to complete the library.
  19.  
  20. =============================================================================
  21.                           General Information
  22. -----------------------------------------------------------------------------
  23.  
  24.   VLIST, consists of a thorough virtual string list system that includes
  25.   functions for many different implementations.  These include database
  26.   browsing, get validation, pop-up menus, pull-down menus, linked lists,
  27.   binary trees, and memory-databases.
  28.  
  29.   All display and pick functions have mouse support that is definable by
  30.   a user-defined function.  Keyboard handling is also routed through
  31.   this UDF to allow filtering and functionallity changes.
  32.  
  33.   Elements in a list can be marked for:
  34.  
  35.       1.  Normal display using __COLOR_STD.
  36.       2.  Displayed using __COLOR_HIT, yet do not allow selecting of this 
  37.           element.
  38.       3.  Displayed using __COLOR_SKIP, yet do not allow cursor to move
  39.           onto element, and do not allow selection.
  40.       4.  Elements HIDDEN and not displayed or selectable.
  41.  
  42.   Each element can be displayed using a different color.
  43.  
  44.   This library will completely replace the use of FORCE's Pick_List() and
  45.   @PROMPT commands with improved versions.  In fact, new to the Pick_List()
  46.   routine are the following:
  47.  
  48.       1.  Mouse support
  49.       2.  Multiple columns
  50.       3.  Different colored elements
  51.       4.  Scroll-bar support
  52.  
  53.   A full pull-down and pop-up menu system is also implemented using a
  54.   string list.  This allows you to have multi-level pull-down menus
  55.   AND pop-up menus stored in ONE place.
  56.  
  57.   NOTE:  see the information at the end of this file for registration
  58.          purposes and on how to get documetation and source code for
  59.          the library.
  60.  
  61. -----------------------------------------------------------------------------
  62.  VLIST FUNCTION/PROCEDURE and VARIABLE LIST
  63. -----------------------------------------------------------------------------
  64. __COLOR_STD                  - color for normal elements
  65. __COLOR_ENHCD                - color for high-lighted elements
  66. __COLOR_SKIP                 - color for 'skipped' elements
  67. __COLOR_HIT                  - color for 'hit' elements
  68. __COLOR_BAR                  - color for scroll-bar
  69. __COLOR_TAB                  - color for scroll-bar tabs
  70. __SCROLL_OFFSET              - scroll-bar column offset from right of PICK
  71.  
  72. VList_1_FPick()              - displays directory listing to pick a filename
  73. VList_Add()                  - a quicker version of VList_Append()
  74. VList_Append()               - append a element to the end of the list
  75. VList_Bol()                  - are we below bottom of list
  76. VList_Bottom()               - goto bottom of list
  77. VList_CCopy()                - copy from current element to another
  78. VList_CDelete()              - delete current element
  79. VList_CEdit()                - change current element's string
  80. VList_CGet_Color()           - get current element's color
  81. VList_CGet_Status()          - get current element's status
  82. VList_CInsert()              - insert before current element
  83. VList_Clear()                - clear and deinitialize list
  84. VList_Copy()                 - copy from one element to another
  85. VList_Count_Elements()       - count number of non-HIDDEN elements in a range
  86. VList_CReplace()             - replace all of current element's parameters
  87. VList_CSet_Color()           - set current element's color
  88. VList_CSet_Status()          - set current element's status
  89. VList_CStr()                 - return current element's string
  90. VList_Default_Key_Handler()  - standardized keyboard handler for PICK
  91. VList_Default_Menu_Handler() - standardized keyboard handler for MENUs
  92. VList_Delete()               - delete a specified element
  93. VList_Edit()                 - change a specified element's string
  94. VList_Empty()                - are there any elements in the list?
  95. VList_Find_First_Good()      - find first element not HIDDEN or SKIPPED
  96. VList_Find_Last_Good()       - find last element not HIDDEN or SKIPPED
  97. VList_Fix_Path()             - support function for VList_1_FPick()
  98. VList_FPick()                - like VList_1_FPick but for MANY files to be selected
  99. VList_Free_Screen()          - free memory from a SAVESCRN()
  100. VList_FullView()             - view a TEXT file using VList_Pick()
  101. VList_Get_Color()            - get a specified element's color
  102. VList_Get_Last_Good()        - goto the previous non-HIDDEN/SKIPPED element
  103. VList_Get_Next_Good()        - goto the next non-HIDDEN/SKIPPED element
  104. VList_Get_Status()           - get a specified element's status
  105. VList_Get_StrLen()           - get the list's max string length
  106. VList_Goto()                 - goto a specific element
  107. VList_Init()                 - initialize and start a list
  108. VList_Insert()               - insert before a specified element
  109. VList_Is_Init()              - is this list initialized?
  110. VList_Locate()               - locate a element in a non-sorted list
  111. VList_Locate_SubStr()        - locate a substring in a non-sorted list
  112. VList_Max()                  - return the number of items in the list
  113. VList_Number()               - return current element number
  114. VList_Pick()                 - multi-column PICK w/mouse and multiple colors.
  115. VList_Pick1()                - one-column PICK w/mouse and multiple colors.
  116. VList_PopUp()                - pop-up menu w/mouse support
  117. VList_PopUp1()
  118. VList_PullDown()             - pull-down menu w/mouse support
  119. VList_PullDown1()
  120. VList_Replace()              - replace all of a specified element's parameters
  121. VList_Restore()              - read a NEW picklist from a disk file
  122. VList_Restore_Append()       - read a picklist onto the end of an existing one
  123. VList_Save()                 - save a picklist to disk (w/encryption)
  124. VList_Save_Append()          - append picklist to picklist disk file
  125. VList_Set_Color()            - set a specified element's color
  126. VList_Set_Status()           - set a specified element's status
  127. VList_Short_Path()           - support function for VList_1_FPick()
  128. VList_Simple()               - one column PICK w/o mouse w/o HIDDEN/SKIPPED
  129. VList_Skip()                 - skip one element forward or backward
  130. VList_Skip_Last()            - skip to previous non-HIDDEN element
  131. VList_Skip_Next()            - skip to next non-HIDDEN element
  132. VList_SmallView()            - view a TEXT file using VList_Small()
  133. VList_Sort()                 - sort a RANGE of element SUBSTRINGs in a list
  134. VList_Sort_SubStr()
  135. VList_Str()                  - return a specified element string
  136. VList_Tol()                  - are we above top of list?
  137. VList_Top()                  - goto top of list
  138. VList_What_Color()           - calculates element's color
  139.  
  140. VMouse_Col()                 - return mouse Col (0-79)
  141. VMouse_Cursor()              - turn mouse cursor on/off
  142. VMouse_Get_Position()        - return mouse cursor position coordinates
  143. VMouse_Init()                - initialize mouse
  144. VMouse_Left_Button()         - is left mouse button pressed?
  145. VMouse_Save()                - save mouse driver settings
  146. VMouse_Set_RowCol()          - set mouse Row/Col
  147. VMouse_Reset()               - reset mouse driver
  148. VMouse_Restore()             - restore mouse driver settings
  149. VMouse_Right_Button()        - is right mouse button pressed?
  150. VMouse_Row()                 - return mouse Row (0-24)
  151.  
  152.  
  153.