Contents of the APICK.DOC file
Copyright (C) Kevin Connearney 1988
PROGRAM: APICK is a program to do for SET SELECTION what ACHOICE()
did for ITEM SELECTION. The APICK() function presents data in the
same manner as ACHOICE() but allows multiple selections rather than
one. The program is written in Clipper, Summer 87 edition. In addition
to linking in the apick object file you'll have to link in the Extend
CONCEPT: The function will process the array you designate. The Array
must have already been declared and filled from a database or other
source. The program allows you to scroll thru the Array with a light bar
for record selection. You select elements by touching the "TAB" key
while the element is highlighted. The key acts as a toggle. Strike it once
- the element is selected and marked on screen(in the example it's marked
with a smiley face); strike it again and it's unmarked in the Array and on
screen. There is no limit to how many elements you can select. The selection
process is ended when you touch the return key. At the conclusion of the
process the Array is left with Marker (smiley face?) sitting in the first
character position of the Array element. You then process the array by
checking for the presence of the Marker. The keys controlling movement are:
UPARROW-scroll up one element; PgUp-scroll up one window; HOME-scroll to
first element of the Array.DNARROW,PgDn and END do the opposite. Everything
truely scrolls. If your at the last element of the Array and touch HOME all
the data will scroll by.
LICENSE: You're free to use the object file in applications you develop
including commercial applications so long as the routine represents an
insignificant portion of the application. You can distribute the object file
to others so long as this document file accompanies it. The author retains
all commercial rights.
HOW TO: The program calling convention is shown clearly in the demo program.
The parameters handed into the program are in order:
1. Top screen row for window. A numeric value or variable.
Must be not less than 3.
2. Left screen row for window. A numeric value or variable.
Must be not less than 2.
3. Bottom screen row for window. A numeric value or variable.
Must be not more than 23.
4. Right screen row for window. A numeric value or variable.
Must be not more than 78.
5. The screen Title. A string literal for the top of the window.
Literal cannot exceed window width.
6. The Array. A literal name of the array to be scrolled.
7. The Clearing Color. The color in use when the window is cleared
8. The Window Color. The color that all but the highlighted data
will show in in the window.
9. The Highlight Color. The color for the scrolling pointer.
10. The marking character. In the demo it is "chr(02)" , a smiley
COMMENTS AND SUGGESTIONS: Please send all comments and suggestions to :
29 Smith Rd
Hingham Ma 02043
SOURCE CODE: Source code is available on disk for $5.00. Send requests to the