home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
C!T ROM 2
/
ctrom_ii_b.zip
/
ctrom_ii_b
/
PROGRAM
/
FOXPRO
/
VLIST110
/
README.1ST
next >
Wrap
Text File
|
1992-10-02
|
8KB
|
153 lines
Virtual List System library (VLIST)
=============================================================================
VLIST is a free product BUT donations are accepted so that I have
motivation to continue developing products such as these. This is
therefore similar to ShareWare. Hopefully the time saved by using
this product is worth a donation <g>... The old ShareWare version
had a registration fee of $45.00.
Jayson R. Minard
P.O. Box 1306
Westminster, CO 80030-1306
You will also notice that full FORCE source code is included with this
release.
JMAKE or Borland's make utility can be used to compile the libraries. You
will need a librarian manager and an assembler to complete the library.
=============================================================================
General Information
-----------------------------------------------------------------------------
VLIST, consists of a thorough virtual string list system that includes
functions for many different implementations. These include database
browsing, get validation, pop-up menus, pull-down menus, linked lists,
binary trees, and memory-databases.
All display and pick functions have mouse support that is definable by
a user-defined function. Keyboard handling is also routed through
this UDF to allow filtering and functionallity changes.
Elements in a list can be marked for:
1. Normal display using __COLOR_STD.
2. Displayed using __COLOR_HIT, yet do not allow selecting of this
element.
3. Displayed using __COLOR_SKIP, yet do not allow cursor to move
onto element, and do not allow selection.
4. Elements HIDDEN and not displayed or selectable.
Each element can be displayed using a different color.
This library will completely replace the use of FORCE's Pick_List() and
@PROMPT commands with improved versions. In fact, new to the Pick_List()
routine are the following:
1. Mouse support
2. Multiple columns
3. Different colored elements
4. Scroll-bar support
A full pull-down and pop-up menu system is also implemented using a
string list. This allows you to have multi-level pull-down menus
AND pop-up menus stored in ONE place.
NOTE: see the information at the end of this file for registration
purposes and on how to get documetation and source code for
the library.
-----------------------------------------------------------------------------
VLIST FUNCTION/PROCEDURE and VARIABLE LIST
-----------------------------------------------------------------------------
__COLOR_STD - color for normal elements
__COLOR_ENHCD - color for high-lighted elements
__COLOR_SKIP - color for 'skipped' elements
__COLOR_HIT - color for 'hit' elements
__COLOR_BAR - color for scroll-bar
__COLOR_TAB - color for scroll-bar tabs
__SCROLL_OFFSET - scroll-bar column offset from right of PICK
VList_1_FPick() - displays directory listing to pick a filename
VList_Add() - a quicker version of VList_Append()
VList_Append() - append a element to the end of the list
VList_Bol() - are we below bottom of list
VList_Bottom() - goto bottom of list
VList_CCopy() - copy from current element to another
VList_CDelete() - delete current element
VList_CEdit() - change current element's string
VList_CGet_Color() - get current element's color
VList_CGet_Status() - get current element's status
VList_CInsert() - insert before current element
VList_Clear() - clear and deinitialize list
VList_Copy() - copy from one element to another
VList_Count_Elements() - count number of non-HIDDEN elements in a range
VList_CReplace() - replace all of current element's parameters
VList_CSet_Color() - set current element's color
VList_CSet_Status() - set current element's status
VList_CStr() - return current element's string
VList_Default_Key_Handler() - standardized keyboard handler for PICK
VList_Default_Menu_Handler() - standardized keyboard handler for MENUs
VList_Delete() - delete a specified element
VList_Edit() - change a specified element's string
VList_Empty() - are there any elements in the list?
VList_Find_First_Good() - find first element not HIDDEN or SKIPPED
VList_Find_Last_Good() - find last element not HIDDEN or SKIPPED
VList_Fix_Path() - support function for VList_1_FPick()
VList_FPick() - like VList_1_FPick but for MANY files to be selected
VList_Free_Screen() - free memory from a SAVESCRN()
VList_FullView() - view a TEXT file using VList_Pick()
VList_Get_Color() - get a specified element's color
VList_Get_Last_Good() - goto the previous non-HIDDEN/SKIPPED element
VList_Get_Next_Good() - goto the next non-HIDDEN/SKIPPED element
VList_Get_Status() - get a specified element's status
VList_Get_StrLen() - get the list's max string length
VList_Goto() - goto a specific element
VList_Init() - initialize and start a list
VList_Insert() - insert before a specified element
VList_Is_Init() - is this list initialized?
VList_Locate() - locate a element in a non-sorted list
VList_Locate_SubStr() - locate a substring in a non-sorted list
VList_Max() - return the number of items in the list
VList_Number() - return current element number
VList_Pick() - multi-column PICK w/mouse and multiple colors.
VList_Pick1() - one-column PICK w/mouse and multiple colors.
VList_PopUp() - pop-up menu w/mouse support
VList_PopUp1()
VList_PullDown() - pull-down menu w/mouse support
VList_PullDown1()
VList_Replace() - replace all of a specified element's parameters
VList_Restore() - read a NEW picklist from a disk file
VList_Restore_Append() - read a picklist onto the end of an existing one
VList_Save() - save a picklist to disk (w/encryption)
VList_Save_Append() - append picklist to picklist disk file
VList_Set_Color() - set a specified element's color
VList_Set_Status() - set a specified element's status
VList_Short_Path() - support function for VList_1_FPick()
VList_Simple() - one column PICK w/o mouse w/o HIDDEN/SKIPPED
VList_Skip() - skip one element forward or backward
VList_Skip_Last() - skip to previous non-HIDDEN element
VList_Skip_Next() - skip to next non-HIDDEN element
VList_SmallView() - view a TEXT file using VList_Small()
VList_Sort() - sort a RANGE of element SUBSTRINGs in a list
VList_Sort_SubStr()
VList_Str() - return a specified element string
VList_Tol() - are we above top of list?
VList_Top() - goto top of list
VList_What_Color() - calculates element's color
VMouse_Col() - return mouse Col (0-79)
VMouse_Cursor() - turn mouse cursor on/off
VMouse_Get_Position() - return mouse cursor position coordinates
VMouse_Init() - initialize mouse
VMouse_Left_Button() - is left mouse button pressed?
VMouse_Save() - save mouse driver settings
VMouse_Set_RowCol() - set mouse Row/Col
VMouse_Reset() - reset mouse driver
VMouse_Restore() - restore mouse driver settings
VMouse_Right_Button() - is right mouse button pressed?
VMouse_Row() - return mouse Row (0-24)