FUNCTION: INITSUP() *** Initializes global variables and conditions
Initializes global variables and conditions
Returns
Nothing
Category
Environment
Syntax
INITSUP()
Description
The first time INITSUP() is called, it simply initializes
the global variables expected by Super.Lib functions if
they are not already present. On subsequent calls, INITSUP() does nothing.
QUERY_EXP is set to "". This is the global
variable used to store the last query built
with QUERY(), and is accesses by many Super.Lib
functions.
_SUPERPRN is set to "LPT1". This is the default
printer for Super.Lib output.
_CHECKPRN is initialized to .T. This variable
tells P_READY() whether or not it should attempt
to check the printer status. On a redirected
printer on a LAN this should be set to .F., as
ISPRN() will not work.
INITSUP() will look for a variable called _SUPISCOLOR. If it is present and of type "L", its value will be used in place of ISCOLOR(). You may want to initialize a public variable _SUPISCOLOR
if you have one of those card/monitor
combos that fool ISCOLOR().
Advanced INITSUP() settings:
System files (used by Super.Lib) all have default
names which may be overridden. The defaults are
contained in a set of public variables. They are:
_REPORTS = "SFREPORT" (for reports)
_FORMS = "FORM" (for form letters)
_QUERIES = "QUERIES" (for queries)
_LISTER = "PLIST" (for lister)
_TODODBF = "TODO" (for todo list)
_TODONTX1 = "TODO" (TODO category INDEX)
_TODONTX2 = "TODOP" (TODO priority INDEX)
_TODONTX3 = "TODOD" (TODO do by INDEX)
_HELP = "HELP" (for help)
_SCROLLER = "SCROLLER" (for scroller)
_COLORS = "COLORS" (for colors)
to override a system file name, set the variable name
FUNCTION: SCROLLER() Hotkey lookup tables with dbf storage
Hotkey lookup tables with dbf storage
Returns
nothing
Category
Lookup
Syntax
SET KEY xxx TO SCROLLER
Scroller([expC1],[expN],[expC2])
Description
Scroller is a hotkey lookup table engine.
Scroller is data-driven , meaning it operates on data stored external to the EXE in SCROLLER.DBF.
SCROLLER() is called via a SET KEY. When called, it recieves the parameters proc_nam and VARIABLE from Clipper, tellingit the proc and variable the user was sitting on when he pressed the hotkey. The actual parameters rec'd areproc_nam, LINE, VARIABLE. Line is ignored, but it s included as the 2nd parameter because it is passed.
SCROLLER() attemps to find a corresponding record in SCROLLER.DBF (which contains fields for proc_nam and VARIABLE). SCROLLER.DBF is a storage place for lookup definitions. If SCROLLER does not find a matching record, it simply closes SCROLLER.DBF and returns to the previous area. It then displays a 'lookup table not found' message.
If SCROLLER finds a matching record, it loads the
values into memory and closes SCROLLER.DBF. It then opens the DBF [and index] of the lookup dbf in
the next available area. If it is unable to open
the dbf, it displays an error message and goes back
to the previously selected area.
SCROLLER then draws a box, using the DESCRIPTION field as the title, ititializes a 1 element array composed of the SSTRING expression and calls
SMALLS() .
While in the SMALLS(), first letter searches can be done if the dbf is indexed with a character index. Pressing ENTER will KEYBOARD the expression in SRETURN (unless its empty), close up the current area and return to the old area. Pressing escape just closes things up and returns to the old area.
The KEYBOARD then takes over, feeding the SRETURN expression into the keyboard and into the current GET or GETS.
FUNCTION: UNBOX() Removes a box created by makebox()
Removes a box created by makebox()
Returns
nothing
Category
Popup
Syntax
Unbox(<expC>,[expN1..expN4])
Description
UNBOX restores the screen <expC> saved by
MAKEBOX(). MAKEBOX() stores the dimensions
and color in the returned string, so it is not
necessary to pass these to UNBOX(). If the dimensions are passed, UNBOX() assumes these are not part of the saved string, and assumes the string is a savescreen() string. If the string and any other
single param are passed, UNBOX() assumes it is
a full screen (0,0,24,79) restore and does so.
Options
[expN1..expN4] - the dimensions of the box.
Use these to UNBOX() a screen saved with SAVESCREEN().