home *** CD-ROM | disk | FTP | other *** search
/ Chip 1999 January / Chip_1999-01_cd.bin / zkuste / delphi / D1 / DBSG.ZIP / readme.txt < prev   
Text File  |  1998-03-24  |  5KB  |  163 lines
  1. TDBSortGrid
  2. ===========
  3.  
  4. Version 1.03 (24 March 1998)
  5. Freeware for Delphi 1.0 and 2.0
  6. Copyright (c) 1998 Greg Lief
  7.  
  8. ----------------------------------------------------------------------------
  9.  
  10. 1.  Description
  11. 2.  Installation
  12. 3.  Properties
  13. 4.  Events
  14. 5.  Usage Notes
  15. 6.  Copyright Notice
  16. 7.  Disclaimer
  17. 8.  Technical Support
  18. 9.  Revision History
  19. 10. Comments
  20. 11. Purchasing Source Code
  21.  
  22. ----------------------------------------------------------------------------
  23.  
  24. 1. Description
  25. ==============
  26.  
  27. This is a TDBGrid derivative that will automatically re-order its data
  28. when one of its column headings is double-clicked.
  29.  
  30. If you are using Delphi 1, this component will only work when attached
  31. to a TTable.  The 32-bit version will handle both TTables and TQueries.
  32.  
  33.  
  34. 2. Installation
  35. ===============
  36.  
  37. A. Choose the Component | Install menu option (or if you are using
  38.    Delphi 1.0, the Options | Install Components menu option).
  39.  
  40. B. Click upon the Add Button, and select either DBSG16.DCU (Delphi 1) or
  41.    DBSG32.DCU (Delphi 2).
  42.  
  43. C. Press OK twice.
  44.  
  45. D. After your component library is recompiled, you will find a new tab
  46.    entitled "Greg Lief", with the TDBSortGrid icon upon it.
  47.  
  48.  
  49. 3. Properties
  50. =============
  51.  
  52. SelectedColor -- This allows you to change the color of the font
  53. used for the column heading currently used for the sort order
  54. (whew! talk about a long sentence).  The default value is clRed.
  55. NOTE: This applies only to the 32-bit version.
  56.  
  57.  
  58. 4. Events
  59. =========
  60.  
  61. OnResort -- This event allows you to react if/when the user decides
  62. to resort the grid.  Here is the syntax for your event handler:
  63.  
  64.    procedure OnResort(Grid : TDBSortGrid ; ColumnIndex : integer )
  65.  
  66. Grid is the grid with which you are working.
  67.  
  68. ColumnIndex is the zero-based ordinal position of the column which
  69. now dictates the sort order.  For example, you can use this as a lookup
  70. into the grid's Columns property.
  71.  
  72.  
  73. 5. Usage Notes
  74. ==============
  75.  
  76. The most important thing to remember is that when you use this component
  77. in conjunction with a TTable, you must have a secondary index for each
  78. field in order for the sort to take place.  If the user double-clicks
  79. upon a column heading and there is no index available for the field in
  80. that column, the user will get the "cannot sort on this column" error.
  81.  
  82. As mentioned above, the Delphi 1 version of this component will only
  83. work with TTables.  The Delphi 2 version will work with TQueries, but be
  84. warned that if your query (SQL property) already includes an ORDER BY
  85. clause, anything from that point forward will be truncated.  (I didn't
  86. have time to put in smarter parsing, sorry.)
  87.  
  88. Also note that the dgColumnResize option is initially disabled.  This is
  89. to avoid the flickering that would otherwise occur when double-clicking
  90. upon a column heading.  (Turn it back on and you'll see exactly what I
  91. mean.)
  92.  
  93.  
  94. 6. Copyright Notice
  95. ===================
  96.  
  97. This component is fully functional.  My copyright notice will appear
  98. when you drop it upon a form at design-time, but that will not occur at
  99. run-time.  You can remove the copyright notice by purchasing the source
  100. code (see item #10 below).
  101.  
  102.  
  103. 7. Disclaimer
  104. =============
  105.  
  106. It is unfortunate that we live in a litigous society in which the
  107. lawyers are generally the only winners.  However, that makes the
  108. following verbiage necessary:
  109.  
  110. "THE CODE FOR THIS COMPONENT IS PROVIDED TO YOU AS IS BY ITS AUTHOR,
  111. GREG LIEF. THE AUTHOR HAS TESTED THE COMPONENT AND FEELS THAT IT WORKS
  112. AS BILLED, BUT MAKES ABSOLUTELY NO GUARANTEES OR WARRANTEES OF ANY KIND.
  113. IN OTHER WORDS, YOU ARE USING THIS ENTIRELY AT YOUR OWN RISK.  NEITHER
  114. THE AUTHOR NOR ANY OTHER ORGANIZATION WILL BE HELD RESPONSIBLE FOR ANY
  115. DIRECT OR INDIRECT DAMAGE RESULTING FROM THE USE OF EITHER THIS
  116. COMPONENT OR ANY DERIVATIVES THEREOF."
  117.  
  118.  
  119. 8. Technical Support
  120. ====================
  121.  
  122. The reason I am making this component available as freeware because I
  123. feel that it will be of use to other Delphi developers. However, always
  124. remember the old maxim "you get what you pay for".  In other words, do
  125. not get carried away by expecting technical support, because you will be
  126. sadly disappointed.
  127.  
  128.  
  129. 9. Revision History
  130. ===================
  131.  
  132. Mar 24, 1998 -- version 1.03: added OnResort event.
  133.  
  134. Mar 21, 1998 -- version 1.02: made index search more flexible (i.e., index
  135.                 names no longer need to match field names).  Also added
  136.                 SelectedColor property.
  137.  
  138. Jun 09, 1997 -- version 1.01: optimized so that the user cannot re-sort
  139.                 the current column (especially important with queries)
  140.  
  141. Feb 14, 1997 -- initial public release
  142.  
  143.  
  144. 10. Comments
  145. ============
  146.  
  147. If you find this component useful, I would appreciate hearing from you
  148. via e-mail (greg@greglief.com).
  149.  
  150. If you would like to learn how to create your own components, you should
  151. strongly consider my Delphi Expert seminar. For more information, visit:
  152. http://www.objectlessons.com/seminars.shtml.
  153.  
  154. The most updated version of this component can always be found at my
  155. personal web site (http://www.greglief.com).
  156.  
  157.  
  158. 11. Purchasing Source Code
  159. ==========================
  160.  
  161. The TDBSortGrid source code is available for $5 US. See the ORDER.TXT
  162. (included in this package) for more details.
  163.