Category : Miscellaneous Language Source Code
Archive   : FILSEL26.ZIP
Filename : FILESELE.DOC

FILESELE.EXE - Easy to use overlay file Selector
for C and PASCAL - style languages by Andy & Cow.
Version 2.60, Jan 8 1993

Andrei N. Tsyganenko INTERNET: [email protected]
7903 Mandan Rd. Apt. #103
Greenbelt, MD 20770


This program allows you to select on a full screen a
filename from any directory for passing its name to
your applications. It includes full directory and
drive changing functions, directory sorting, search
mask, entry of new file name and OS shell.

Main functions:

Highlighted name movement: Up, Dn, PgUp, PgDn, Home, End.

File choose: Highlight required name and press .

Exit Selector without file select: . It will return
to caller only PATH where you pressed .

Catalog change: Select required directory name and press
. If you selected "..", then directory name from
which you just exited, will be highlighted.

Drive change: Press and choose drive name in upper
line by Right and Left arrows and press , or press
required drive letter. returns to select function
without any drive change.

Additional functions:

Enter search mask: Press and enter new search
mask, then press . If you will press
instead of , search mask will be *.* (any file).

Choose sorting order: Press and choose from
four (Size, Name, Extension, Date) or None (files are in
directory order). Press and choose direction of
sorting: or , and accept chosen by .
returns to main select function without order change.

Enter new file name: Press and enter new file
name. will accept this file name, will
return to Selector main function.

OS shell: Press ^S and you will see usual DOS prompt.
Use usual EXIT command to return to Selector.

Mouse support: Movement up/down/right/left is equal to Up/Dn/
Right/Left arrows, left button is equal to , right
button is equal to in all subfunctions menu. In main
select function it switches to drive select subfunction.

Usage:
From high-level languages: Use EXEC or other similar function
to run Selector with passing parameters in command line. First
parameter is memory address in hexadecimal notation Segment:Offset,
where to look for initial selecting path with mask and where to
store selected file name. Second parameter is optional for use
in PASCAL language, /P - it forces Selector to deal with PASCAL
strings. Otherwise it uses C string standard (ASCIIZ). Demo
source coding for Turbo Pascal included in this package. Don't
forget to make {$M...} directive in your programs.

Config file:
FILESELE.CFG consists of two lines; in first there is a search
mask, which is used in case if there is no search mask in passed
initial string. In second line there are two digits: first is
number of sorting order (0=None, 1=Name, 2=Size, 3=Ext, 4=Date)
and the second one is sorting direction (0=Inc, 1=Dec).
If FILESELE.CFG is absent in current directory when FILESELE.EXE
started, then "*.*" mask and no sorting is used.

Screen save/restore:
In text video modes, current screen contents will be saved and
after exit from Selector will be restored.

Restrictions: Maximum files number is 300, but I hope that
it's enough. This version has switched off mouse support
and screen saving functions.

Demo:
Run FS_CALL program and follow instructions.
It will ask you about filename and then list the file on your screen.

.TPU version:
If you want to have Turbo Pascal 6.0 TPU version of Selector,
check X in respective box of the registration form.

As soon as I'll have other translators, other formats will be
available.

This version was compiled with 80286 instructions and checks
presence of 80286+ in the system. If you want to have 8086/8088-
compatible code, check X in respective box of the registration form.

Distribution:
Original FILSEL26.ZIP archive contains 6 files:

FILESELE.EXE - main module
FILESELE.DOC - this documentation
FILESELE.CFG - configuration file
FS_CALL .PAS - demo source for Turbo PASCAL
FS_CALL .EXE - demo exe
CRC .DOC - PKZIP CRC report for previous 5 files

Copying and redistribution is encouraged, but must be the
original, unmodified file containing this documentation.

This is SHAREWARE. If you intend to use this program after
evaluation, please send me five dollars for registration,
form for registration included. For ten dollars and post-paid
floppy sender I will send you new version with included mouse
support and screen saving/restore function. For .TPU version
check additional box in registration form. If you want to use
Selector as part of your commercial product, contact me for
details. I will accept any suggestions and comments about
Selector. Thanks.

Mail to:

Andrei N. Tsyganenko
7903 Mandan Rd., Apt. #103
Greenbelt, MD 20770

Cost ( U.S. Funds, no credit cards ):
$5 <=> registration
$10 + post-paid floppy sender <=> last version + mouse support +
+ screen save/restore functions + .TPU version.


FILESELE registration Version 2.51

Name: ___________________________________________________

Address: ________________________________________________

________________________________________________

$5 enclosured.

Translator which you use: _______________________________

[ ] Send me the last version of Selector with mouse support
and screen save/restore functions ($10 and post-paid
floppy sender enclosured)

[ ] Include Turbo Pascal 6.0 TPU version | Check only
| if the first
[ ] Include version for 8086/8088 | box checked

E-mail address: _________________________________________

Comments, suggestions: __________________________________

_________________________________________________________

_________________________________________________________


Turbo Pascal is a trademark of Borland International.