Contents of the COMEATTR.DOC file
PREVIEWS OF COMING ATTRACTIONS:
DBTOOLS VERSION 2.0 "PRO"
I am presently working on a dBTools 2.0 "PRO" version, and making good
progress. Current users of earlier versions of dBTools will be notified
by mail and offered version 2.0 PRO at a reduced upgrade price.
Version 2.0 will have a total of 40 functions (see list below). Some
processes require more than one function number (such as PULLDOWN), but
many functions have subfunctions and so perform multiple operations.
Many new functions have been added, and enhancements made to existing
functions. Version 2.0 will have increased capacity, and will be easier
to work with.
MORE USER FRIENDLY: (User friendlier?)
Instead of the cryptic function number, the names of the functions can
be used for increased readability. For example,
CALL DBTOOLS WITH "ATSAY,5,15,11/1,0,Hello, world!"
Function numbers can still be used if desired (they execute slightly
Color pair specification is of the form FG/BG, where either color
digits 0-15, or dBASE style color specifications (ie, +w/n and so on),
can be used interchangeably. Digits execute slightly faster.
Syntax help may be displayed by calling dBTools with the function name
or number, and a ?. For example, CALL DBTOOLS WITH "ATSAY,?" will
display the syntax for the atsay function.
Error diagnostics also display the syntax along with the offending
Store up to 4 screen images instead of 3.
Increased memory for windows, up to 30 open at a time.
The WINDOW function supports a Title.
Box and windows may be "exploding".
The BLAT and TWIDDLE sound effects have been combined into one function
with multiple options/subfunctions, and ALARM, CHIRP, BLIP, and CLICK
sound effects added (total of 5).
Self contained pulldown menu systems which don't require all the
external loops that version 1.3 does to implement them, and operate at
the speed of assembly language. Actually, if you're familiar with
FoxPro's menuing systems, PULLDOWN is similar.
Menu functions can have a message associated with each of the menu
items. You can specify which row the message will appear, its colors,
and justification (centered, left, right).
Menus can have a hotkey other than the first letter, which will appear
highlighted from the rest of the menu item text. Inactive menu selections
are supported, which will appear in a different color in the menu, but
which cannot be selected. This would give the ability to enable only
certain menu selections based on user security level.
All menus support mouse control.
Monochrome monitors supported.
You can optionally specify the shape of the cursor in the cursor function.
The SAVESCR function allows you to save the current screen to a file as
well as a memory slot.
Encrypt - encrypt and decrypt a string of up to 128 characters. Good
for passwords or sensitive data.
Color Schemes - Define up to 12 sets of 10 color pairs, which can be
used in place of FG/BG specifications in a number of dBTools functions.
A color scheme consists of 10 color pairs which define colors of
1) Standard @SAY color
2) GET highlight color
3) Window frame
4) "Wallpaper" background
5) Menu active item (unselected)
6) Menu selected item (highlighted)
7) Menu inactive item
8) Menu hotkey highlight
9) Message color
10) Title color
Dialog Buttons - a different kind of menu. Similar to a horizontal
moving bar menu, except that the "buttons" can be placed in any
position on screen. Tab and Shift Tab cycles through each of the
choices and Enter selects, or you can click on a button with the mouse.
Move and Copy Window - windows can be moved from one place on screen to
another, or duplicated in another place.
Stuff Keyboard - characters can be stuffed into the keyboard buffer as
if you typed them.
Flush keyboard buffer.
Define trappable hotkeys in menu functions, pause, and GETKEY.
Get directory information; get files matching a wildcard skeleton and
extract filename, filesize, and filedate info.
Scrollable picklists, where you may choose one item to operate on
immediately, or a "checkmark" mode where multiple items may be checked
for later processing.
Some more code examples, such as some "canned" utilities (Backup,
reindex files, user definable Browse, file Pack/Purge, printer driver)
which can be easily customized and included in your applications.
LIST OF DBTOOLS FUNCTIONS:
1. ATSAY alternative to @ SAY
2. EFFECTS sound effects
3. BOX framed, shadowed, exploding boxes
4. CURSOR control cursor shape and attributes
5. ERASE erase an area of the screen
6. DELAY programmable delays
7. DITHER create over 100 background colors
8. FADE slideshow like screen fades
9. HMENU horizontal moving bar menu
10. PAUSE a more elegant WAIT
11. PRINTER printer attribute control
12. READSCR read a screen image from a file
13. RECOLOR recolor an area of the screen
14. RESTSCR restore a saved screen image from memory
15. SAVESCR save current screen to memory or a file
16. SCROLL scroll an area of the screen
17. PLAY play musical tones
18. TWIDDLE a three note sound effect (also included in EFFECTS)
19. UNPOP remove a window and restore underlying screen
20. VMENU vertical moving bar menu
21. WINDOW popup window
22. PAGE select active video page
23. NOBLINK select blinking or high intensity background attributes
24. PALETTE set EGA/VGA color palette
25. GETKEY get a ketstroke and return unambiguous codes
26. DIALOG dialog buttons
27. MOUSE mouse control
28. ENCRYPT encrypt/decrypt strings
29. SCHEME color schemes
30. STUFF stuff keyboard buffer
31. COPYWIND copy a window
32. MOVEWWIND move a window
33. PULLDOWN activate pulldown menu system
34. HPROMPT define horizontal menu pad
35. VDEF define popup vertical menu
36. VPROMPT define vertical menu bar
37. KEYDEF define trappable keystrokes
38. DUPESCR duplicate an area of the screen
39. GETDIR get file information
40. PICKLIST scrollable picklist