/*************************************************************************/

                  Borland Visual Solutions Pack, Volume 1
                             README.TXT

  This README file contains important information regarding the Borland
  Visual Solutions Pack Volume 1.  Read this entire file for the latest
  information about the Borland Visual Solutions Pack Volume 1.


-----------------
TABLE OF CONTENTS
-----------------
1. Installation
2. Custom Controls
3. Important Information


---------------
1. INSTALLATION
---------------
To install the Borland Visual Solutions Pack onto your hard disk:

  1. Insert the Borland Visual Solutions Pack Install disk into
     drive A or B of your computer.

  2. Select File|Run from Windows 3.1 or Windows for Workgroups 3.1x.

  3. Enter A:INSTALL (or B:INSTALL) on the input line.

  4. Fill in directories as appropriate.  The install program creates
     an appropriate Window group and installs the Borland Visual
     Solutions Pack according to the directories you select.

NOTE:   In order for the OWL examples to work properly on a hard-disk
        system, install the Borland Visual Solutions Pack Volume 1 on
        the same drive as Borland C++ 4.0.

        If you're running Borland C++ 4.0 from a CD-ROM or network, or
        if you cannot install the Visual Solutions Pack Volume 1 on the
        same drive as BC4, change the directories used in your project
        and make files to reflect your system.


------------------
2. CUSTOM CONTROLS
------------------
The Borland Visual Solutions Pack Volume 1 comes complete with more than
30 VBX custom controls.  Custom controls are pre-made, reuseable components
that let you add extensive functionality to your Windows applications.  
Because the controls are incorporated into your applications via a visual
programming methodology, you can add the functionality of the control with
virtually no coding effort.

The Borland Visual Solutions Pack Volume 1 v1.1 provides the following VBX
controls:

Word Processor (TX4VB.VBX)
	Drop in a WYSIWYG text editor with multiple typefaces, fonts, and point
  sizes.  Also includes a ruler, ribbon, and status bar.

Spreadsheet (VTSS.VBX)
	Add full featured spreadsheets that display and calculate data.

Notebook Tabs (SAXTABS.VBX)
	Organize spreadsheets or any application into a 3D notebook.

Communications (SAXCOMM.VBX)
	Create serial communications interfaces with terminal emulation and
  XModem file transfer.

Image Editor (KNIFE.VBX)
	Display images in a variety of formats that can be zoomed, panned,
  cropped, sharpened, and softened.

3D Charts (TKCHART.VBX)
	Add over 30 3D and 2D charts that can be rotated, resized, and formatted
  in a variety of ways.

Database (SQC.VBX)
	Create data base front ends that access dBASE and Paradox tables, even
  in a networked environment.

Gadgets (ANIBRT.VBX, MHGA200.VBX, MHSN200.VBX, MHSL200.VBX, MHMQ200.VBX,
   MHCL200.VBX, MHAL200.VBX, MHDC200.VBX, MHCD200.VBX)
	Give your user-interfaces a professional look with animated	buttons,
  gauges, spinners, sliders, marquees, clocks, alarms, dice, and cards.


FOR BORLAND C++ 4.0:
--------------------
Custom controls are loaded from within Resource Workshop:

	1.  Select File|Install control library.

	2.  Choose a file with a .VBX extension.

An icon for the custom control is automatically added to the Tools Palette.

NOTE:   The Borland Visual Solutions Pack installs all custom controls
        into the WINDOWS\SYSTEM directory.  To use a control, drag the
        control onto a dialog box as you would with the standard Borland
        controls.  To change a control's properties, double click the
        control to bring up a list of properties.  Properties can be
        changed either at design time (using Resource Workshop) or at
        run-time (using the TVbxControl class if you are creating an
        ObjectWindows application).  If you are developing your
        application using the AppExpert, you can add a handler by
        right-clicking the control to bring up the ClassExpert.

The TVbxControl class is provided by ObjectWindows 2.0 to encapsulate the
retrieving and setting of properties for VBX custom controls.  This process
is further facilitated by a utility called VBXGen, which can be found in
BC4\BIN.  VBXGen derives a class from TVbxControl for the custom control
selected, and then generates member functions for modifying all the
properties associated with the control.  VBXGen also generates a header
file that contains the class definition.


FOR BORLAND dBASE 5.0 for WINDOWS
---------------------------------
Custom controls are loaded from within the Forms Designer:

  1.  Select File|Setup custom controls.

  2.  Choose a file with a .VBX extension.

An icon for the custom control is automatically added to the custom tab of
the Control Palette.

NOTE:   The Borland Visual Solutions Pack installs all custom controls
        into the WINDOWS\SYSTEM directory.  To use a control, drag the
        control onto a form as you would with any of the standard Borland
        dBASE 5.0 for Windows controls.  To change a control's properties,
        double click the control to bring up a list of properties.
        Properties can be changed either at design time by using Forms
        Designer or at run-time.


FOR MICROSOFT VISUAL BASIC AND VISUAL C++
-----------------------------------------
Please refer to their respective documentation on loading and using VBX
custom controls.


------------------------
4. IMPORTANT INFORMATION
------------------------
Please read the The following important information:


General
-------

-  The custom controls provided with the Borland Visual Solutions Pack
   Volume 1 v1.1 support Visual Basic 1.0 only.

-  If you plan to use this release of BVSP in Borland C++ 4.0 with any
   previously created applications using the Integra/VDB database grid
   control, you must recreate the DLGINIT section of your resource files
   as the control has changed internally.

-  If you plan to build applications with a large number of database
   tables, you must include the following line in your AUTOEXEC.BAT file:

      SHARE /F:10000 /L:200

   Re-boot the system for the changes to AUTOEXEC.BAT to take effect.

   If SHARE is not activated, file-locking features supported by the ODBC
   drivers might not be available.  The options specified in the command
   line set the buffer size and number of locks used by SHARE.  If you do
   not allocate enough SHARE buffers, you might receive errors while
   opening cursors or joining multiple tables. 

-  Additional information on the use of these custom controls can be found
   in the BVSP\VOL1 directory.  Look for files called READ_xxx.TXT where
   {xxx} represents the host language (BC; DBW; VB; or VC) you may be
   interested in.


Database Controls
-----------------

-  Applications with a large number of Dialogs/Forms might get a stack
   overflow message.  To avoid this problem, increase the default stack
   size to 20000.

-  Use of the ODBC.DLL driver may generate an error message:

          "Error No 11020... Environment handle HENV allocation failed".

   This error message occurs when the following condition exists:

     The log file as named in the ODBC.INI file does not yet exist,
     AND the TRACE flag is set to 0 in the ODBC.INI file.  (TRACE=0)

   The resolution is to perform one of these operations:

     1) Modify the ODBC.INI file and set the TRACE=0 line to TRACE=1
     2) Load the ODBC administrator, located in the VSP program group and
        check the trace ODBC calls checkbox:
	
        a) Click on the Options... button
        b) Check on the Trace ODBC Calls.
        c) Click on the OK button
        d) Click on the Close button

     3) Create the logfile as named in the ODBC.INI file with either none
        or some characters in it.  Note that this assumes that the log file
        name is SQL.LOG, key in whatever name is shown in the ODBC.INI file.
        From the command line type:  

        a) Copy con SQL.LOG   
        b) Enter a character, can be a blank
        c) Enter Ctrl-Z and hit RETURN


dBASE 5.0 for WINDOWS
---------------------

-  Header files necessary for use with the custom controls can be included
   in one of three ways:

     1. Copy c:\BVSP\INCLUDE\*.DBH files to your DBASEWIN\INCLUDE directory
     2. Copy c:\BVSP\INCLUDE\*.DBH files to your program directory
     3. Change the example program to point to the path where these files
        are located -> C:\BVSP\INCLUDE is the default.

-  The dBASE 5.0 for Windows Tutorial of the TX Text control, in STEP01 has
   you load the .VBX file from the C:\WINDOWS\SYSTEM directory.  Before you
   actually SAVE your form, change the path back to the Tutorial directory
   using the Properties|Desktop|Files.  Otherwise the form will be saved in
   the C:\WINDOWS\SYSTEM directory.

-  The DICE example uses the DBTIMER.VBX shipped with dBASE 5.0 for Windows
   and therefore needs to know where that file is located.  You may either
   include the DBASEWIN\SAMPLES directory in your DOS PATH setting or copy
   the .VBX files from the DBASEWIN\SAMPLES directory to the WINDOWS\SYSTEM
   directory before running this example.


/**************************** END OF FILE ********************************/

