True DBGrid 4.0                                       February 18, 1996
"Bonanza" Version                             APEX Software Corporation
-----------------------------------------------------------------------

Welcome
=======

  Thank you for purchasing True DBGrid!  We hope that you will find
  it to be a valuable tool for developing database applications with
  Microsoft Visual Basic 4.0.

New Features Included in On-Line Help
=====================================

  Several features were added to the product and to the on-line help
  file after the printed manual went to press: AddNewMode property,
  OnAddNew event, Paint event.  Also, the on-line help now includes
  a reference section (Chapter 15) for constants defined by the True
  DBGrid control.
  
True DBGrid Migration Tool
==========================

  This utility is provided for converting from either DBGrid or True
  DBGrid Standard Edition to the full-featured version of True DBGrid.
  Please see Chapter 1 of the manual or the True DBGrid Help for
  detailed instructions.

  The True DBGrid Migration Tool does NOT convert from TrueGrid Pro 
  (TRUEGRID.VBX) to True DBGrid (OCX).  Please see "TrueGrid Pro
  Migration Guide" below for infomration on VBX to OCX conversion.

TrueGrid Pro Migration Guide
============================

  If you are a TrueGrid Pro user, please be sure to view the TrueGrid
  Pro Migration Guide.  This help file contains a wealth of useful
  information to assist you in the transition from TrueGrid Pro 
  (TRUEGRID.VBX) to True DBGrid (TDBG16.OCX or TDBG32.OCX):

  - Why is the OCX so different from the VBX?
  - Tables that summarize VBX-OCX property and event mappings.
  - Code samples that demonstrate conversions on a per-property basis.
  - Tips for implementing column summaries in True DBGrid.

Free VSFlex/OCX
===============

  A free copy of VideoSoft VSFlex/OCX is included for users who
  purchased the True DBGrid-VSFlex bundle special.  VSFlex/OCX is
  also included for TrueGrid Pro users who upgraded to True DBGrid.

Workaround for Modal Forms
==========================

  Several users have reported a problem that occurs when True DBGrid
  (or DBGrid) is used in a modal form.  (The Visual Basic help file 
  has outlined certain limitations when using a modal form.)  The 
  symptoms are a flickering display followed by an "out of stack space" 
  error.  The cause of this problem has not yet been found, but there 
  is a workaround:

  - At design time, set Form.Enabled = False.
  - In Form_Load, set Form.Enabled = True.
  - In Form_QueryUnload, set Form.Enabled = False.


Files Needed to Distribute Applications Using True DBGrid
=========================================================

  Two files are necessary to distribute True DBGrid, TDBG##.OCX and 
  GRDKRN##.DLL (where "##" is "16" or "32").  TDBG##.OCX is a self-
  registering OCX.  It will automatically register when your application 
  is run on the target machine.  For the self-registration to occur, it 
  is necessary to copy GRDKRN##.DLL and TDBG##.OCX to a directory in the 
  path (such as Windows\System) or to the directory from which the 
  application is run.  

Remote Data Control
===================

  When using True DBGrid with the Remote Data Control, it is necessary 
  to convert the grid's bookmarks to a form the Remote Data Control can 
  use.  The following function will perform the necessary conversion.  

  Private Function ToRDCBkmk(StdBkmk As Variant) As Variant
    '
    ' Converts a grid Bookmark variant to an RDC Bookmark variant
    '
    Dim Bkmk As String
    Dim RDCBkmk As Long
    Bkmk = StdBkmk
    RDCBkmk = AscB(MidB(Bkmk, 4, 1))
    RDCBkmk = 256 * RDCBkmk + AscB(MidB(Bkmk, 3, 1))
    RDCBkmk = 256 * RDCBkmk + AscB(MidB(Bkmk, 2, 1))
    RDCBkmk = 256 * RDCBkmk + AscB(MidB(Bkmk, 1, 1))
    ToRDCBkmk = RDCBkmk
  End Function

  For example, use this function to move the current record of the RDC to 
  the last bookmark in the grid's SelBookmarks collection:  

  Private Sub Command1_Click()
    Dim LastSelBookmark As Variant
    LastSelBookmark = TDBGrid1.SelBookmarks(TDBGrid1.SelBookmarks.Count - 1)
    MSRDC1.Resultset.Bookmark = ToRDCBkmk(LastSelBookmark)
  End Sub


