Category : BASIC Source Code
Archive   : CZLIS110.ZIP
Filename : CZLIST.DOC

CzarList
Custom Controls for VBDOS

Version 1.10
October 29, 1994

Copyright (c) 1994 by CZAR Software
All Rights Reserved.
P.O. Box 370087
El Paso, TX 79937-0087
USA

Support BBS: (915) 595-8705
Voice: (915) 595-8787
CompuServe: 71031,3614
Fax: (915) 595-8787
Fido: 1:381/99


Ú---------¿
Ú-----Á---¿ ³ (R)
--³ ³o ³------------------
³ Ú-----ÁÐ--¿ ³ Association of
³ ³ ³-Ù Shareware
À---³ o ³ Professionals
------³ º ³--------------------
À----Ð----Ù MEMBER


STAR (Shareware Trade Association and Resources) MEMBER


All other product names mentioned herein are trademarks of
their respective companies.

CzarList is produced by a member of the Association of
Shareware Professionals (ASP). ASP wants to make sure that
the shareware principle works for you. If you are unable to
resolve a shareware-related problem with an ASP member by
contacting the member directly, ASP may be able to help. The
ASP Ombudsman can help you resolve a dispute or problem with
an ASP member, but does not provide technical support for
member products. Please write to the ASP Ombudsman at 545
Grover Road, Muskegon, MI 49442-9427 or send a CompuServe
message via CompuServe Mail to ASP Ombudsman 70007,3536.
The OMB may be contacted by FAX by sending to the ASP FAX
number: (616) 788-2765. In communication with the OMB please
include a telephone number and/or FAX if available.

==============================================================
Contents Page 1
-------- --------

Introduction
What is CzarList. . . . . . . . . . . . . . . . . . . . 2
Features. . . . . . . . . . . . . . . . . . . . . . . . 3

Setup
Hardware Requirements . . . . . . . . . . . . . . . . . 4
Software Requirements . . . . . . . . . . . . . . . . . 4

Operating CzarList
How to use CzarList . . . . . . . . . . . . . . . . . . 5
CzList (Properties, Events, Methods). . . . . . . . . . 6
Custom Property: Max (Integer) . . . . . . . . . . . 7
Custom Property: Mode (Integer). . . . . . . . . . . 8
Custom Property: Sorted (Boolean). . . . . . . . . . 9
Custom Property: Value (Integer) . . . . . . . . . . 10
Custom Method: CLS (Method). . . . . . . . . . . . . 11
Custom Method: REFRESH (Method). . . . . . . . . . . 12
CzDir (Properties, Events, Methods) . . . . . . . . . . 13
Custom Property: Drive (String). . . . . . . . . . . 14
Custom Property: Max (Integer) . . . . . . . . . . . 15
Custom Property: Mode (Integer). . . . . . . . . . . 16
Custom Property: Sorted (Boolean). . . . . . . . . . 17
Custom Property: Value (Integer) . . . . . . . . . . 18
Custom Method: CLS (Method). . . . . . . . . . . . . 19
Custom Method: REFRESH (Method). . . . . . . . . . . 20
CzFile (Properties, Events, Methods). . . . . . . . . . 21
Custom Property: Max (Integer) . . . . . . . . . . . 22
Custom Property: Mode (Integer). . . . . . . . . . . 23
Custom Property: Path (String) . . . . . . . . . . . 24
Custom Property: Sorted (Boolean). . . . . . . . . . 25
Custom Property: Value (Integer) . . . . . . . . . . 26
Custom Method: CLS (Method). . . . . . . . . . . . . 27
Custom Method: REFRESH (Method). . . . . . . . . . . 28
CzGetWhatKindMem%() . . . . . . . . . . . . . . . . . . 29
CzItemsTagged%(). . . . . . . . . . . . . . . . . . . . 30
CzAllowTagging% (YesNo%). . . . . . . . . . . . . . . . 31
CzKeyBTagScrolling% (YesNo%). . . . . . . . . . . . . . 32
CzMouTagScrolling% (YesNo%) . . . . . . . . . . . . . . 33
CzSetVirtualPath% (PathToSet$). . . . . . . . . . . . . 34
CzSetStartFileNumber% (FileNumber%) . . . . . . . . . . 35
Troubleshooting . . . . . . . . . . . . . . . . . . . . 36
The Future. . . . . . . . . . . . . . . . . . . . . . . 37

Appendix
A. What you get when you register . . . . . . . . . . . 38
B. Registration Form . . . . . . . . . . . . . . . . . 39
C. Get the newest releases of CzarList . . . . . . . . 40
D. What is shareware and how does it work . . . . . . . 41

License Agreement. . . . . . . . . . . . . . . . . . . . . 42

Warranty Disclaimer. . . . . . . . . . . . . . . . . . . . 43

Copyright Notice . . . . . . . . . . . . . . . . . . . . . 44

==============================================================
What is CzarList Page 2
---------------- --------

Welcome to CzarList, the most powerful custom control library
for VBDOS.

CzarList offers 3 Custom ListBox Controls for VBDOS
Programmers. All three controls use XMS, EMS, or disk space to
store the data. Easily store up to 32,765 items per listbox
without using any string space or conventional memory. Each
listbox control fully supports tagging and untagging. Also,
all controls support the .CLS method so you can quickly clear
the contents in a fraction of a second even if you store up
32,767 items. No need to use .REMOVEITEM anymore.

CzarList is NOT freeware nor public domain. CzarList is
shareware. CzarList is copyrighted. CZAR Software retains
ownership of that copyright. Anyone who continues to use
CzarList after a trial period of 30 days is obligated to
purchase CzarList by paying a small registration fee. Only
with your support, CzarList can be continued to be developed
and improved.

==============================================================
Features Page 3
-------- --------

The CzarList Control library features:

o CzList, a general listbox which you can use to display
pretty much any data as long as the data is string data
(variable length or fixed length).

o CzDir, displays alphabetically sorted directories in
graphical tree format. CzDir stores the graphical tree to
display as well as the directory paths.

o CzFile, displays files with name, size, date, time, and
attributes.

==============================================================
Hardware Requirements Page 4
--------------------- --------

- 80286 or better
- 512K RAM


==============================================================
Software Requirements
---------------------

- MS-DOS v3.30 or higher
- VBDOS v1.00 or higher


==============================================================
How to use CzarList Page 5
------------------- --------

The source code for the DEMO program is fully documented
and shows how to use the controls. The demo program shows
many examples on how each control could be used. To run the
demo from the DOS prompt, use DEMO.EXE. To run the demo in
the VBDOS programming environment, type the following from
the DOS prompt: VBDOS DEMO.MAK /L CZLIST

Everything runs without any restrictions. You can use the
Quick Library CZLIST.QLB to test and run your programs.
When you register CzarList, you will receive the CZLIST.LIB
file so that you can create your own EXE files. Use file
REGISTER.DOC or CREDIT.DOC to register.


Make sure the following files are included in this package:

CATALOG DOC - The CZAR Software product catalog
CREDIT DOC - How to order with your credit card
CZLIST DOC - This file
CZLIST QLB - Quick Library for VBDOS
DEMO EXE - An example program of CzarList
DEMO FRM - Demo form file (ASCII Format)
DEMO MAK - Demo make file
DEMO BAS - Demo source module file
DEMOALL FRM - Demo form file (ASCII Format) that shows CzDir
and CzFile
DEMODIR FRM - Demo form file (ASCII Format) that shows CzDir
DEMOFILE FRM - Demo form file (ASCII Format) that shows CzFile
FILE_ID DIZ - BBS description file, a short desciption of
CzarList
GENERAL FRM - A general form file (ASCII Format)
ORDER FRM - How to order CzarList (ASCII Format)
PACKING LST - A list of all files included in this package
README DOC - This file
REGISTER DOC - The registration file for CzarList
VENDOR DOC - Disk vendors should read this
WHATSNEW DOC - List the newest improvments
{SDA ID} - A description file for the SDN network
distribution

Total = 20 Files

==============================================================
CzList (Properties, Events, Methods) Page 6
------------------------------------ --------

CzList is a general listbox control. You can use it to
display and list any kind of information. Each element in
the listbox can be up to 76 characters long. It fully
supports tagging and untagging.

CzList will first try to use XMS memory. If no XMS memory
is available, it will try to use EMS memory. If no XMS and
no EMS memory is available, CzList will use the disk as
virtual memory.

The amount of conventional memory used will not change even
if you put 32,765 (the maximum) elements into CzList.

You must UNLOAD the form or control(s) before you end your
program. CzList will then remove itself from memory. If you
do not UNLOAD the form or control, the memory used by
CzList (either CMS, EMS, or disk space) will not be released
and unpredictable results can occur.

IMPORTANT: Do not set an index with the ADDITEM method when
adding items into the listbox for the first time.
For example, do NOT use the following method:

FOR i = 1 TO 100
CzList.ADDITEM "Some string", i
NEXT

The correct usage is:

FOR i = 1 TO 100
CzList.ADDITEM "Some string"
NEXT

Usually, you fill your listbox in the FORM_LOAD
procedure. After you have filled CzList with
your items, you can use ADDITEM with an index
number throughout your program. If you do not
fill your listboxes in the FORM_LOAD procedure
for the first time, you should use a flag to
first initialize the position in the listbox.
For example:

SUB AddAnItem (ItemToAdd$, Position%)

STATIC FillFlag% ' Keep value

IF NOT FillFlag% THEN
CzList.ADDITEM ItemToAdd$
FillFlag% = -1 ' True
ELSE
CzList.ADDITEM ItemToAdd$, Position%
END IF

END SUB

Properties:
BackColor BorderStyle CtlName DragMode
Enabled ForeColor Height Index
LargeChange Left List() ListCount
ListIndex *Max *Mode MousePointer
Row *Sorted TabIndex TabStop
Tag Text Top *Value
Visible Width

Events:
Change Click DblClick DragDrop
DragOver DropDown GotFocus KeyDown
KeyPress KeyUp LostFocus MouseDown
MouseMove MouseUp Resize Timer

Methods:
ADDITEM *CLS DRAG HIDE
MOVE PRINT *REFRESH REMOVEITEM
SETFOCUS SHOW

Note: Custom Properties, Events, and Methods have an asterisk
"*" next to the names.

==============================================================
CzList (Properties, Events, Methods) Page 7
------------------------------------ --------

******************************
Custom Property: Max (Integer)
******************************
Description: The Max property initializes CzList and
prepares the control to be used in your
forms. The Max property can be set or
returned. It tells CzList the maximum
number of elements ever to be used. This
simply means that during runtime you will
never use more than Max of elements in the
listbox.

You can only set the Max property once.
You should do this when your program
first starts up or set the Max property
in the Form Designer. Once the Max
property has been set, it MUST not be
changed during runtime. The maximum
value is 32765.

Usage: [FORM.]CzList.Max = Integer%

Remarks: It is absolute necessary that you use
the Max property. If you do not set the
Max property, you will get error #52
(Bad File Name or Number).

==============================================================
CzList (Properties, Events, Methods) Page 8
------------------------------------ --------

*******************************
Custom Property: Mode (Integer)
*******************************
Description: The Mode property forces CzList to use
certain kinds of storage methods. The Mode
property can be set or returned. Use it
only if you really need it. By default,
CzList will first try to use XMS memory.
If no XMS memory is available, CzList will
try to use EMS memory instead. If no EMS
memory is available, CzList will then use
the disk as virtual memory.

If you force CzList to use XMS Memory,
CzList will still try to use EMS memory if
no XMS memory is available. If no EMS
memory is available, CzList will use the
disk.

If you force CzList to use EMS memory, do
NOT run your program in the VBDOS
environment as it will not work correctly.
You have to compile your program into an
EXE file.

In order for CzarList to use any Extended
memory (XMS), you need to load an extended
memory driver such as HIMEM.SYS. In order for
CzarList to use any Expanded memory (EMS),
you need to load an expanded memory driver
such as EMM386 (for 80386 computers) etc.

Usage: [FORM.]CzList.Mode = Integer%

Remarks: The MODE property has to be set before you
call any other CzList commands and before
you load the form or control. Set the Mode
property before the Max property.

Integer% Description
--------------------------------------------------------------
-1 Use XMS Memory
-2 Use EMS Memory
-3 Use the disk as virtual memory

==============================================================
CzList (Properties, Events, Methods) Page 9
------------------------------------ --------

*********************************
Custom Property: Sorted (Boolean)
*********************************
Description: Sets or returns the sorted status of the
control. CzList will only sort the list
everytime you set the Sorted property. It
will not sort the list when you use the
ADDITEM method. The more elements you have
stored in CzList, the longer it will take to
sort CzList. This can take a very long time
if you have up to 32,765 elements.

The internal sorting method is a Shellsort.
The Shellsort is by far the fastet sorting
method compared to other sorting algorithms
such as bubble sort, exchange sort, quick
sort, etc. The sorting routine in CzList is
written in optimized VBDOS source code because
there are no sorting algorithms for XMS or
EMS data that can be used with VBDOS custom
controls.

Usage: [FORM.]CzList.Sorted = Boolean%

Remarks: Set the Sorted property to true if you want
the list to be sorted.

Boolean% Description
--------------------------------------------------------------
TRUE(-1) The list will be sorted
FALSE(0) The list will not be sorted

==============================================================
CzList (Properties, Events, Methods) Page 10
------------------------------------ --------

********************************
Custom Property: Value (Integer)
********************************
Description: The Value property sets or returns the
tagging action. Setting the Value
property causes all items in the list
to be tagged or untagged.

Usage: [FORM.]CzList.Value = Integer%

Remarks: Use the CzAllowTagging% function to allow
tagging by the user or not.

Integer% Description
--------------------------------------------------------------
1 Tag all elements
2 Untag all elements

==============================================================
CzList (Properties, Events, Methods) Page 11
------------------------------------ --------

***************************
Custom Method: CLS (Method)
***************************
Description: Invoking the CLS method causes the control
to clear all items stored. It will also
clear the display from any items currently
listed.

Usage: [FORM.]CzList.CLS

Remarks: Not available at design time. The .CLS method
is the fastest way to clear the control in a
fraction of a second. This eliminates using
the slow .REMOVEITEM method.

==============================================================
CzList (Properties, Events, Methods) Page 12
------------------------------------ --------

*******************************
Custom Method: REFRESH (Method)
*******************************
Description: Invoking the REFRESH method causes the control
to update the screen display. You must use the
REFRESH method after you are finished using
the ADDITEM method. This has been done to
improve the performance. If you do not use the
REFRESH method, the user will see an empty
listbox until a CLICK event has occured.

Usage: [FORM.]CzList.REFRESH

Remarks: Not available at design time.

==============================================================
CzDir (Properties, Events, Methods) Page 13
----------------------------------- --------

CzDir is a directory listbox control. It displays an
alphabetically sorted, graphical directory tree. It fully
supports tagging and untagging.

CzDir will first try to use XMS memory. If no XMS memory
is available, it will try to use EMS memory. If no XMS and
no EMS memory is available, CzDir will use the disk as
virtual memory.

The amount of conventional memory used will not change even
if all 32,765 (the maximum) elements are used.

You must UNLOAD the form or control(s) before you end your
program. CzDir will then remove itself from memory. If you
do not UNLOAD the form or control, the memory used by
CzDir (either CMS, EMS, or disk space) will not be released
and unpredictable results can occur.

Properties:
BackColor BorderStyle CtlName DragMode
*Drive Enabled ForeColor Height
Index LargeChange Left List()
ListCount ListIndex *Max *Mode
MousePointer Row *Sorted TabIndex
TabStop Tag Text Top
*Value Visible Width

Events:
Change Click DblClick DragDrop
DragOver DropDown GotFocus KeyDown
KeyPress KeyUp LostFocus MouseDown
MouseMove MouseUp Resize Timer

Methods:
ADDITEM *CLS DRAG HIDE
MOVE PRINT *REFRESH REMOVEITEM
SETFOCUS SHOW

Note: Custom Properties, Events, and Methods have an asterisk
"*" next to the names.

==============================================================
CzDir (Properties, Events, Methods) Page 14
----------------------------------- --------

*******************************
Custom Property: Drive (String)
*******************************
Description: Sets or returns the current drive to read.
CzDir reads the entire drive including all
directory paths. It will then display
a graphical tree structure. The tree
structure is alphabetically sorted,
including subdirectories. CzDir reads all
directories including hidden ones.

Usage: [FORM.]CzDir.Drive = String$

Remarks: Example: CzDir.Drive = "C:" would read drive
C: into CzDir.

Reading the List() property would return the
full path of a list element. See the DEMO
for examples.

==============================================================
CzDir (Properties, Events, Methods) Page 15
----------------------------------- --------

******************************
Custom Property: Max (Integer)
******************************
Description: See CzList

Usage: [FORM.]CzDir.Max = Integer%

Remarks: See CzList

==============================================================
CzDir (Properties, Events, Methods) Page 16
----------------------------------- --------

*******************************
Custom Property: Mode (Integer)
*******************************
Description: See CzList

Usage: [FORM.]CzDir.Mode = Integer%

Remarks: See CzList

==============================================================
CzDir (Properties, Events, Methods) Page 17
----------------------------------- --------

*********************************
Custom Property: Sorted (Boolean)
*********************************
Description: See CzList

Usage: [FORM.]CzDir.Sorted = Boolean%

Remarks: See CzList

==============================================================
CzDir (Properties, Events, Methods) Page 18
----------------------------------- --------

********************************
Custom Property: Value (Integer)
********************************
Description: See CzList

Usage: [FORM.]CzDir.Value = Integer%

Remarks: See CzList

==============================================================
CzDir (Properties, Events, Methods) Page 19
----------------------------------- --------

***************************
Custom Method: CLS (Method)
***************************
Description: See CzList

Usage: [FORM.]CzDir.CLS

Remarks: See CzList

==============================================================
CzDir (Properties, Events, Methods) Page 20
----------------------------------- --------

*******************************
Custom Method: REFRESH (Method)
*******************************
Description: See CzList

Usage: [FORM.]CzDir.REFRESH

Remarks: See CzList

==============================================================
CzFile (Properties, Events, Methods) Page 21
------------------------------------ --------

CzFile is a file listbox control. It displays file name,
file size, file date, file time, and file attributes. It
fully supports tagging and untagging.

CzFile will first try to use XMS memory. If no XMS memory
is available, it will try to use EMS memory. If no XMS and
no EMS memory is available, CzDir will use the disk as
virtual memory.

The amount of conventional memory used will not change even
if all 32,765 (the maximum) elements are used.

You must UNLOAD the form or control(s) before you end your
program. CzFile will then remove itself from memory. If you
do not UNLOAD the form or control, the memory used by
CzFile (either CMS, EMS, or disk space) will not be released
and unpredictable results can occur.

Properties:
Action Alignment Archive AutoRedraw
BackColor BorderStyle Caption Checked
Column ControlID CtlName CurrentX
CurrentY Drive DragMode Enabled
Filename ForeColor Height Hidden
Index Interval LargeChange Left
List() ListCount ListIndex *Max
Min *Mode MousePointer MultiLine
Normal *Path Pattern ReadOnly
Row ScaleHeight ScaleWidth ScrollBars
SelLength SelStart SelText SmallChange
*Sorted Style System TabIndex
TabStop Tag Text Top
TypeID *Value Visible Width

Events:
Change Click Custom DblClick
DragDrop DragOver DropDown GotFocus
KeyDown KeyPress KeyUp LostFocus
MouseDown MouseMove MouseUp Paint
PathChange PatternChange Resize Timer

Methods:
ADDITEM *CLS DRAG HIDE
MOVE PRINT REFRESH REMOVEITEM
SETFOCUS SHOW

Note: Custom Properties, Events, and Methods have an asterisk
"*" next to the names.

==============================================================
CzFile (Properties, Events, Methods) Page 22
------------------------------------ --------

******************************
Custom Property: Max (Integer)
******************************
Description: See CzList

Usage: [FORM.]CzFile.Max = Integer%

Remarks: See CzList

==============================================================
CzFile (Properties, Events, Methods) Page 23
------------------------------------ --------

*******************************
Custom Property: Mode (Integer)
*******************************
Description: See CzList

Usage: [FORM.]CzFile.Mode = Integer%

Remarks: See CzList

==============================================================
CzFile (Properties, Events, Methods) Page 24
------------------------------------ --------

******************************
Custom Property: Path (String)
******************************
Description: Sets or returns the current path to read.
CzFile reads all files in the specified
path, including hidden and system files.

CzFile reads and displays filename,
filesize, filedate, filetime, and
fileattributes in one operation.

Wildcards are fully supported and MUST
be included when setting the Path
property.

Usage: [FORM.]CzDir.Path = String$

Remarks: Example: CzDir.Path = "C:\CZLIST\*.*" would
read all files in C:\CZLIST.

Reading the List() property would return the
full path and filename of a list element.
See the DEMO for examples.

==============================================================
CzFile (Properties, Events, Methods) Page 25
------------------------------------ --------

*********************************
Custom Property: Sorted (Boolean)
*********************************
Description: See CzList

Usage: [FORM.]CzFile.Sorted = Boolean%

Remarks: See CzList

==============================================================
CzFile (Properties, Events, Methods) Page 26
------------------------------------ --------

********************************
Custom Property: Value (Integer)
********************************
Description: See CzList

Usage: [FORM.]CzFile.Value = Integer%

Remarks: See CzList

==============================================================
CzFile (Properties, Events, Methods) Page 27
------------------------------------ --------

***************************
Custom Method: CLS (Method)
***************************
Description: See CzList

Usage: [FORM.]CzFile.CLS

Remarks: See CzList

==============================================================
CzFile (Properties, Events, Methods) Page 28
------------------------------------ --------

*******************************
Custom Method: REFRESH (Method)
*******************************
Description: See CzList

Usage: [FORM.]CzFile.REFRESH

Remarks: See CzList

==============================================================
CzGetWhatKindMem%() Page 29
------------------- --------

Description: The CzGetWhatKindMem% function returns what kind
of memory has been used to store the data in
CzList, CzDir, or CzFile.

Declaration: DECLARE FUNCTION CzGetWhatKindMem% ()

Usage: Result% = CzGetWhatKindMem%

Example: CzList.SETFOCUS
SELECT CASE CzGetWhatKindMem%
CASE -1
d$ = "XMS Memory"
CASE -2
d$ = "EMS Memory"
CASE ELSE
d$ = "Disk"
END SELECT
MSGBOX (d$)

Result% Description
--------------------------------------------------------------
-1 Uses XMS memory
-2 Uses EMS memory
-3 Uses Disk as virtual memory

Remark: None.

==============================================================
CzItemsTagged%() Page 30
---------------- --------

Description: The CzItemsTagged% function returns the number
if items tagged in CzList, CzDir, or CzFile.

Declaration: DECLARE FUNCTION CzItemsTagged% ()

Usage: NumberOfItems% = CzItemsTagged%

Example: CzList.SETFOCUS
MSGBOX ("Items tagged: " + STR$(CzItemsTagged%))

Remark: None.

==============================================================
CzAllowTagging% (YesNo%) Page 31
------------------------ --------

Description: You can use the CzAllowTagging% function to
force CzList, CzDir, or CzFile to allow tagging
or not.

Declaration: DECLARE FUNCTION CzAllowTagging% (YesNo%)

Usage: Result% = CzAllowTagging%(YesNo%)

Example: CzList.SETFOCUS
YesNo% = 0
Result% = CzAllowTagging%(YesNo%)

YesNo% Description
--------------------------------------------------------------
0 Allow tagging
1 Allow no tagging

Remark: None.

==============================================================
CzKeyBTagScrolling% (YesNo%) Page 32
---------------------------- --------

Description: You can use the CzKeyBTagScrolling% function to
force CzList, CzDir, or CzFile to allow scrolling
to the next item in the list when tagging with the
SPACE BAR.


Declaration: DECLARE FUNCTION CzKeyBTagScrolling% (YesNo%)

Usage: Result% = CzKeyBTagScrolling%(YesNo%)

Example: CzList.SETFOCUS
YesNo% = 0
Result% = CzKeyBTagScrolling%(YesNo%)

YesNo% Description
--------------------------------------------------------------
0 Scroll to next item
1 Scroll not to next item

Remark: CzAllowTagging% must be set to yes (0) for
CzKeyBTagScrolling% to work.

==============================================================
CzMouTagScrolling% (YesNo%) Page 33
--------------------------- --------

Description: You can use the CzMouTagScrolling% function to
force CzList, CzDir, or CzFile to allow scrolling
to the next item in the list when tagging with the

right mouse button.

Declaration: DECLARE FUNCTION CzMouTagScrolling% (YesNo%)

Usage: Result% = CzMouTagScrolling%(YesNo%)

Example: CzList.SETFOCUS
YesNo% = 0
Result% = CzMouTagScrolling%(YesNo%)

YesNo% Description
--------------------------------------------------------------
0 Scroll to next item
1 Scroll not to next item

Remark: CzAllowTagging% must be set to yes (0) for
CzMouTagScrolling% to work.

==============================================================
CzSetVirtualPath% (PathToSet$) Page 34
------------------------------ --------

Description: If CzList, CzDir, or CzFile uses the disk as
virtual memory, you will see a slowdown in
performance the more elements you use. For
this reason, you can tell the control where
to store the temporary disk file(s) by setting
CzSetVirtualPath$ to the path you want to use.

It is recommended to use a RAMDRIVE for this
purpose. If you do not specify a path for
CzSetVirtualPath$, CzList will use the current
path.

Note: You MUST set CzSetVirtualPath$ before
you set the Max Property. The best way
to do this is to set CzSetVirtualPath$
as the first command in your FORM_LOAD
procedure.

Declaration: DECLARE FUNCTION CzSetVirtualPath% (PathToSet$)

Usage: Result% = CzSetVirtualPath%(PathToSet$)

Example: CzList.SETFOCUS
PathToSet$ = "I:\TEMP"
Result% = CzSetVirtualPath%(PathToSet$)

Remark: Make sure the drive has enough space left to
save the disk file(s). You can calculate the
amount of bytes needed using the following
formular:

DiskSpace& = (CzList.Max + 1) * 76

For example, if you want to use 2000 elements
and CzList, CzDir, or CzFile needs to use the
disk, you would have to make sure that there
are at least (1999 + 1) * 76 = 152,000 Bytes
available.

==============================================================
CzSetStartFileNumber% (FileNumber%) Page 35
----------------------------------- --------

Description: If you force CzList, CzDir, or CzFile to use
virtual memory with CzarList.Mode = -3, CzList,
CzDir, or CzFile will now use filenumbers
starting with #10. This should prevent error #55
(File Already Open). If you need more than 9
files open for your own programs, you can tell
CzList, CzDir, or CzFile with the
CzSetStartFileNumber% function what starting
filenumber to use.

Declaration: DECLARE SUB CzSetStartFileNumber% (FileNumber%)

Usage: CALL CzSetStartFileNumber%(FileNumber%)

Example: CzList.SETFOCUS
CALL CzSetStartFileNumber(15)

Remark: None.

==============================================================
Troubleshooting Page 36
--------------- --------

Problem 1: CzarList does not use any extended or expanded
*********** memory; eventhough, there is plenty available.

Cause: You did not load an extended or expanded
memory driver.

Solution 1: In order for CzarList to use any Extended
memory (XMS), you need to load an extended
memory driver such as HIMEM.SYS. In order for
CzarList to use any Expanded memory (EMS), you
need to load an expanded memory driver such as
EMM386 (for 80386 computers) etc.


Problem 2: Error #52, "Bad File Name or Number" comes
*********** up as soon as I start my program.

Cause: You did not initialize by setting the Max
property.

Solution 1: Please read the section for setting the
Max property.


Problem 3: Problems getting the GotFocus event when using
*********** the access key to try to move to a custom
control such as CzList, CzFile, or CzDir.

Cause: This is a confirmed bug in Microsoft VBDOS v1.00.

Solution 1: None. Please complain as much as you can directly
at Microsoft so they can get off their butts
and fix the dozens or so other bugs in VBDOS
as well. While you're at it, order Microsoft
to develop a Windows '95 without the graphical
interface = DOS v7.0 (a 32-bit MS-DOS). They
would never do it, since it would allow DOS
to live on and on.

If you encounter any other errors or strange behaviors of
CzarList, please call 915-595-8787 or call the support BBS
at 915-595-8705. Only if you report the errors, CzarList
can be corrected and improved. While you are reporting
errors, any suggestions are welcome!

==============================================================
The Future Page 37
---------- --------

There are currently three CzarList controls: CzList, CzDir,
and CzFile. CzarList can easily be expanded to include other
useful controls such as a message box with more than 3
buttons, a text box control that can hold up to 16 MB of text
(the VBDOS textbox control is limited to 32 KB of string
space), invisible listbox controls to store up to 2,4
GigaBytes (GB) of integer, long integer, double, or currency
numbers (not just up to 32,765 items) perfect for number
crunching and financial programs, an input control to force
input and output format, etc. Of course, all controls would
be able to use XMS, EMS, or virtual memory.

The development of these new controls depend on how many
people would request them and enough people registering
CzarList. If you have new ideas for new controls, please
contact CZAR Software.

==============================================================
Appendix A. What you get when you register Page 38
------------------------------------------ --------

o The CZLIST.LIB object library to build your own EXE files
o A professionally printed and bound manual
o Most current Version of CZLIST.LIB
o Discounts on other CZAR Software products (see CATALOG.DOC)
o FREE, update notices and bug reports
o FREE, lifetime voice Support at 915-595-8787
o FREE, lifetime fax Support
o FREE, lifetime BBS Support at 915-595-8705
o FREE, lifetime CompuServe Support at 71031,3614
o FREE, lifetime AOL Support at czarsoft
o FREE, lifetime InterNet Support at [email protected]

You are more than welcome to upload your finished programs
to the CZAR Software support BBS at 915-595-8705. The best
once will be made available for worldwide download (if you
have a shareware or demo version).

==============================================================
Appendix B. CzarList Registration Form Page 39
-------------------------------------- --------

CZAR Software Registration Form
(Please write in print)


Name:_______________________________________________________

Company:____________________________________________________

Address:____________________________________________________

City, State, Zip:___________________________________________

Country:____________________________________________________

Home Phone:__________________ Work Phone:___________________


------------------------------------------------------------
Q | Product | CIS | Cr. | DM | US$ | Price
--|---------------------|------|-----|-------|-------|------
| ACZAR f. DOS | 420 | yes | 59,00 | 35.00 |
| ACZAR f. Windows | 2107 | yes | 59,00 | 35.00 |
| ACZAR f. DOS German | 420 | yes | 59,00 | 35.00 |
| TUCC | no | no | 35,00 | 25.00 |
| CZLIST | 2907 | yes |129,00 | 69.00 |
------------------------------------------------------------
Plus shipping/handling (US$ 5.00 for each product)...:
(If you pay in German DM or live in Germany, please
read the file CATALOG.DOC.)
------------------------------------------------------------
Total amount is in [ ] US$ or in [ ] DM..............:
============================================================


Q = Quantity
CIS = CompuServe Registration Number (GO SWREG)
Cr. = Can be paid with Credit Card. Please read CREDIT.DOC
for more information on how to pay with Credit Card.
DM = Price of the product in German Mark (Deutsche Mark)
US$ = Price of the product in USA Dollars
Price = Subtotal (Q * DM or US$)

All products are shipped on 3.5" floppy disks.

Please send registration to: CZAR Software
P.O. Box 370087
El Paso, TX 79937-0087
USA

Comment:____________________________________________________

____________________________________________________________

____________________________________________________________

==============================================================
Appendix C. Get the newest releases of CzarList Page 40
----------------------------------------------- --------

The newest releases of CzarList are available at no cost 24
hours a day on the support BBS in El Paso, TX (915) 595-8705.

In addition, you can download CzarList on these fine BBS:

USA:
1. Computer Connection . . . . . . . . . . . . 1-201-886-8041
2. Download America . . . . . . . . . . . . . 1-203-673-2502
3. Lightning Board . . . . . . . . . . . . . . 1-205-745-4515
4. Letters . . . . . . . . . . . . . . . . . . 1-206-524-4811
5. Northern Lights . . . . . . . . . . . . . . 1-207-761-4782
6. RunWay 2400 . . . . . . . . . . . . . . . . 1-215-623-6203
RunWay HST . . . . . . . . . . . . . . . . 1-215-623-6103
RunWay v.32 . . . . . . . . . . . . . . . . 1-215-622-7563
7. Amcom . . . . . . . . . . . . . . . . . . . 1-216-526-9480
8. Back Door . . . . . . . . . . . . . . . . . 1-217-762-2847
9. Programmers Corner . . . . . . . . . . . . 1-301-596-1180
10. Paradox . . . . . . . . . . . . . . . . . . 1-302-645-7264
11. Wyoming . . . . . . . . . . . . . . . . . . 1-307-856-3601
12. The Panhandle Connection. . . . . . . . . . 1-308-487-5505
13. Software Creations 2400 . . . . . . . . . . 1-508-365-2359
Software Creations 9600 . . . . . . . . . . 1-508-368-4131
Software Creations 14,400 . . . . . . . . . 1-508-368-4137
14. Channel I . . . . . . . . . . . . . . . . . 1-617-354-3137
15. A Quiet Place In The Woods 9600 . . . . . . 1-706-769-9977
16. CZAR (Home of CZAR Software). . . . . . . . 1-915-595-8705

GERMANY:
18. K.-L. Jaeger. . . . . . . . . . . . . . . . +49-7665-99153

==============================================================
Appendix D. What is shareware and how does it work Page 41
-------------------------------------------------- --------

Shareware distribution gives users a chance to try software
before buying it. If you try a Shareware program and continue
using it, you are expected to register. Individual programs
differ on details -- some request registration while others
require it, some specify a maximum trial period. With
registration, you get anything from the simple right to
continue using the software to an updated program with
printed manual.

Copyright laws apply to both Shareware and commercial
software, and the copyright holder retains all rights, with
a few specific exceptions as stated below. Shareware authors
are accomplished programmers, just like commercial authors,
and the programs are of comparable quality. (In both cases,
there are good programs and bad ones!) The main difference
is in the method of distribution. The author specifically
grants the right to copy and distribute the software,
either to all and sundry or to a specific group. For
example, some authors require written permission before a
commercial disk vendor may copy their Shareware.

Shareware is a distribution method, not a type of software.
You should find software that suits your needs and
pocketbook, whether it's commercial or Shareware. The
Shareware system makes fitting your needs easier, because
you can try before you buy. And because the overhead is
low, prices are low also. Shareware has the ultimate
money-back guarantee -- if you don't use the product, you
don't pay for it.

==============================================================
License Agreement Page 42
----------------- --------

You may freely distribute your executable programs in the
compiled .EXE file format.

You are NOT required to display CZAR Software copyright
notices or pay royalties.

==============================================================
Warranty Disclaimer Page 43
------------------- --------

Users of CzarList must accept this disclaimer of warranty:
"CzarList is supplied as is. The author disclaims all
warranties, expressed or implied, including, without
limitation, the warranties of merchantability and of fitness
for any purpose. The author assumes no liability for damages,
direct or consequential, which may result from the use of
CzarList."

This CzarList (without the CZLIST.LIB Object library file)
is a "shareware program" and is provided at no charge to
the user for evaluation. The shareware version of CzarList
does not contain CZLIST.LIB. CZLIST.LIB is part of the
registered version. Feel free to share the shareware
version of CzarList with your friends, but please do not
give it away altered or as part of another system. The
essence of "user-supported" software is to provide
personal computer users with quality software without
high prices, and yet to provide incentive for programmers
to continue to develop new products. If you find this
program useful and find that you are using CzarList and
continue to use CzarList after a reasonable trial period,
you must make a registration payment of $69.00 to CZAR
Software. The $69.00 registration fee will license one
copy for use on any one computer at any one time. You
must treat this software just like a book. An example
is that this software may be used by any number of
people and may be freely moved from one computer
location to another, as long as there is no possibility
of it being used at one location while it is being used
at another, just as a book cannot be read at the same
time by two different persons at two locations.

Commercial users of CzarList must register and pay for
their copies of CzarList within 30 days of first use or
their license is withdrawn. Site-License arrangements may
be made by contacting CZAR Software.

Anyone distributing CzarList for any kind of remuneration
must first contact CZAR Software at the address below for
authorization. This authorization will be automatically
granted to distributors recognized by the (ASP) as adhering
to its guidelines for shareware distributors, and such
distributors may begin offering CzarList immediately
(However, CZAR Software must still be advised so that the
distributor can be kept up-to-date with the latest version
of CzarList).

You are encouraged to pass a copy of CzarList along to your
friends for evaluation. Please encourage them to register
their copy if they find that they can use it. All
registered users will receive a copy of the latest version
of the CzarList system.

CZAR SOFTWARE DISCLAIMS ALL WARRANTIES RELATING TO THIS
SOFTWARE, WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT
LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE, AND ALL SUCH WARRANTIES
ARE EXPRESSLY AND SPECIFICALLY DISCLAIMED. NEITHER CZAR
SOFTWARE NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE
CREATION, PRODUCTION, OR DELIVERY OF THIS SOFTWARE SHALL
BE LIABLE FOR ANY INDIRECT, CONSEQUENTIAL DAMAGES ARISING
OUT OF THE USE OR INABILITY TO USE SUCH SOFTWARE EVEN IF
CZAR SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES OR CLAIMS. IN NO EVENT SHALL CZAR SOFTWARE'S
LIABILITY FOR ANY DAMAGES EVER EXCEED THE PRICE PAID FOR
THE LICENSE TO USE THE SOFTWARE, REGARDLESS OF THE FORM OF
CLAIM. THE PERSON USING THE SOFTWARE BEARS ALL RISK AS TO
THE QUALITY AND PERFORMANCE OF THE SOFTWARE.

This agreement shall be governed by the laws of the State of
Texas and shall inure to the benefit of CZAR Software and any
successors, administrators, heirs and assigns. Any action or
proceeding brought by either party against the other arising
out of or related to this agreement shall be brought only in
a STATE or FEDERAL COURT of competent jurisdiction located
in El Paso County, Texas. The parties hereby consent to in
personal jurisdiction of said courts.

==============================================================
Copyright Notice Page 44
---------------- --------

Copyright Notice

THIS SOFTWARE AND THE DISKS OR ANY OTHER MEDIA ON WHICH IT
IS CONTAINED IS LICENSED TO YOU, FOR YOUR OWN USE. THIS IS
COPYRIGHTED SOFTWARE. YOU ARE NOT OBTAINING TITLE TO THE
SOFTWARE OR ANY COPYRIGHT RIGHTS. YOU MAY NOT SUBLICENSE,
RENT, LEASE, CONVEY, MODIFY, TRANSLATE, CONVERT TO ANOTHER
PROGRAMMING LANGUAGE, DECOMPILE, OR DISASSEMBLE THE SOFTWARE
FOR ANY PURPOSE. YOU MAY MAKE AS MANY COPIES OF THIS SOFTWARE
AS YOU NEED FOR BACK-UP PURPOSES ONLY. YOU MAY USE THIS
SOFTWARE ON MORE THAN ONE COMPUTER, PROVIDED THERE IS NO
CHANCE IT WILL BE USED SIMULTANEOUSLY ON MORE THAN ONE
COMPUTER. IF YOU NEED TO USE THE SOFTWARE ON MORE THAN ONE
COMPUTER SIMULTANEOUSLY, PLEASE CONTACT CZAR SOFTWARE FOR
INFORMATION ABOUT SITE LICENSES.