home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / clipper / pow_tb.zip / POWER_TB.TXT < prev    next >
Text File  |  1993-05-25  |  7KB  |  131 lines
  1. POWER_TB.ZIP - POWER TBROWSE
  2. Release 1.02 - 25 May 1993 - ZIP format
  3.  
  4. Exploit the full power of Clipper's tBrowse by stacking many
  5. fields in a single column, word wrapping long text in a single
  6. column, filtering, editing and more!
  7.  
  8. TBrowse is a very powerful utility included as part of Clipper 5.
  9. Unfortunately, the Clipper documentation, even the new
  10. documentation with release 5.2, does not explain the full power
  11. of tBrowse. Example programs supplied with Clipper, and available
  12. from Computer Associates (and formerly Nantucket) as after market
  13. help are generally poorly commented, complex, and difficult to
  14. understand. This leaves you to discover how to fully exploit
  15. tBrowse by experiment, or to live in ignorance. Well, now you
  16. have a third option available to you via POWER_TB.ZIP.
  17.  
  18. I have spent dozens of hours single stepping through tBrowse
  19. code that I have developed and instrumented, unravelling the way
  20. that tBrowse operates. This has allowed me to implement much
  21. more powerful tBrowse routines than before, often avoiding the
  22. need to develop customised table browsing code for my
  23. applications. For instance; the plain vanilla tBrowse explained
  24. in the Clipper documentation allows you to put one field in one
  25. column of one row - fine if you have short fields and lots of
  26. columns. But what if your client wants to see all of the data
  27. for one record on the screen at once, or if you have long text
  28. fields? Well, tBrowse DOES allow you to do this by stacking
  29. fields in a column, or by wrapping text within a column, but how
  30. to do it is not explained in the documentation. I have found
  31. out how to do this, as well as such simple tricks as editing
  32. and filtering, and the results are included in the source code
  33. files of POWER_TB.ZIP.
  34.  
  35. The following source code files are included in POWER_TB.ZIP.:
  36.  
  37.         tbSimple.prg    A simple tBrowse example.
  38.         tbSimpl2.prg    A simple tBrowse example with editing.
  39.         tbFilt1.prg     A filtered tBrowse without SET FILTER.
  40.         tbFilt2.prg     Another way of filtering a tBrowse
  41.                         without SET FILTER.
  42.         tbStack1.prg    Several fields stacked in one column of a
  43.                         tBrowse.
  44.         tbStack2.prg    As tbStack1 with empty fields omitted.
  45.         tbWrap1.prg     A long text field is word wrapped into a
  46.                         single column of the tBrowse.
  47.  
  48. I have included the very simple examples, and the examples of how
  49. to filter without the use of SET FILTER for completeness. There
  50. is also an example database called "supplier.dbf" that is used
  51. by the example programs. This contains details taken from an old
  52. product directory circulated by Nantucket, so don't take any of
  53. the product information as gospel! It's only used as an example,
  54. and I have used Nantucket as the filter criterion to avoid any
  55. charge of favouritism.
  56.  
  57. Place the source files and the example database in a subdirectory
  58. under c:\clipper5\source, or wherever you normally put your
  59. source code. You can use the supplied batch file power_tb.bat to
  60. compile and link the code if you have generated the BASE50
  61. pre-linked library file. If you haven't, do so right away - it
  62. will save you disk space and link time! Alternatively, you can
  63. compile and link however you normally do. 
  64.  
  65. Execute each program to see the effects described above. I have
  66. deliberately kept the bells and whistles in each program to a
  67. minimum to make each effect easier to see and understand, rather
  68. than doing everything in one massively complex example. If you
  69. like what you see, you now have a choice - you can either
  70. examine the source code yourself to understand how it works (and
  71. each example is fairly easy to follow if you are well
  72. experienced in Clipper programming) OR you can take the easy
  73. route and buy my full report on tBrowse - "tBrowse Techniques".
  74.  
  75. The report contains over 70 pages of text, figures and example
  76. code, and explains the way the examples work in much more detail
  77. than could be done through the use of comments. The report not
  78. only explains how each of the examples works in detail, but also
  79. explains the operation of a tBrowse object from the simplest
  80. basics of object oriented programming, through the way that it
  81. works with the data sources and screen display, up to the full
  82. functionality of the examples contained in POWER_TB.ZIP. This is
  83. done in far more detail than the documentation supplied with
  84. Clipper, so that you can see how to develop your own tBrowse
  85. techniques.
  86.  
  87. POWER_TB.ZIP and the source code files contained are hereby
  88. placed in the public domain, and may be freely copied and
  89. distributed, subject only to the following caveats. However,
  90. please respect the time and effort that I have put into
  91. investigating the tBrowse object and producing the examples in
  92. POWER_TB.ZIP, and comply with the following conditions:
  93.  
  94. 1. No charge may be made for distributing POWER_TB.ZIP, apart
  95.    from a small fee for copying and administration.
  96.  
  97. 2. POWER_TB.ZIP must be distributed complete and without
  98.    alteration, including this file, the source code files listed
  99.    above, and the example database. You may not copy or
  100.    distribute the source code, or functional fragments thereof,
  101.    to others except in the form of the complete compressed file
  102.    POWER_TB.ZIP.
  103.  
  104. 3. You may include the source code, or fragments thereof,
  105.    distributed with POWER_TB.ZIP in your own programs without
  106.    restriction. I ask only that if you use the code in a
  107.    commercial application, you purchase a copy of the report.
  108.    You'll find it worth it from the additional possibilities it
  109.    opens up.
  110.    
  111. The special report, TBrowse Techniques, professionally presented
  112. in a handy lay-flat spiral binding, costs just £15 (including
  113. postage and packing to addresses in the UK. Overseas orders
  114. should add £2 for surface shipping, £5 for air mail.) Please
  115. send cheques, postal or money orders, or cash to:
  116.  
  117.         D B Boettcher
  118.         19 Millbank Close
  119.         Chelford
  120.         Cheshire SK11 9SJ
  121.         ENGLAND
  122.         
  123. Please make cheques, etc. payable to D B Boettcher. Sorry, I
  124. can't accept payment by Credit Card or in Overseas Currency at
  125. the moment. You can contact me via the UK Computer Associates
  126. Bulletin Board on 0753 550 707; 8 data, 1 stop, no parity.
  127.  
  128. If you would like a disk of the source code from TBrowse
  129. Techniques, which includes the latest versions of the examples
  130. contained in POWER_TB.ZIP and some more example code, please add
  131. £5, and specify whether you require a 3.5" or 5.25" disk.