home *** CD-ROM | disk | FTP | other *** search
/ CD Shareware Magazine 1996 December / CD_shareware_12-96.iso / WIN / Programa / RP_SHELL.ZIP / README.TXT < prev    next >
Encoding:
Text File  |  1996-05-28  |  3.5 KB  |  84 lines
  1. RP_SHELL1 Contains two components. They must be installed in Delphi.
  2.  
  3. They were developed using ReportPrinter 1.1e and require that you have and own
  4. a legal copy of such product.
  5.  
  6. After registering and installing the components open the project SHELDEMO.DPR.
  7.  
  8. Then compile and run.
  9.  
  10. Most of the source code in the demo is pretty self-explanitory or commented.
  11.  
  12. The example DEMOFORM.PAS shows a very generic usage of these components.
  13.  
  14. The "Detail" report is a simple listing of a random sequence with sub-grouping.
  15. The "Master-Detail" report is a listing of items with the above detail report
  16. nested inside of each master item's header & footer.
  17. The "Master-Master-Detail" report is a modification of the above example in
  18. two significant ways. It shows that these components can be nested as many
  19. times as is necessary and also that multiple detail objects or even
  20. master-detail object combos can be used by a parent master object. See the
  21. "OnValidateChild" event for details.
  22.  
  23. These reports will be 1 page, about 10 pages and about 100 pages respectively.
  24.  
  25. The properties to the left of the buttons are to allow you to experiment with
  26. these features to see how they effect the output.
  27.  
  28. The "Reprint..." properties makes the system trigger the "OnPrintHeader..."
  29. event, due to a page break, with the necessary parameter to distinguish it
  30. from a normal header print event.
  31.  
  32. There is also an example of how to use the public method "PrintHeader" to
  33. generate the page-header. This again triggers the OnPrintHeader event and
  34. provides a parameter to distinguish a user initiated event from a normal or
  35. system reprint triggered event.
  36.  
  37. There are two other public methods "PrintGroupHeader" and "PrintNewPage".
  38.  
  39. The "NewPageOn..." properties generate a new page per each component's item.
  40. It will keep headers of nested components together though. ( Which is good. )
  41.  
  42. Other event parameters worthy of special mention are the "OnPageBreakBefore"
  43. and "OnPageBreakAfter" with parameters of "VAR AbortNewPage" and "Aborted".
  44. If in the before page event the parm AbortNewPage is set to true the events
  45. will continue to fire ( Up the chain of nested components ) but when the
  46. highest parent component is reached the call to BaseReport.NewPage will be
  47. skipped and no new page will be generated. "AbortNewPage" will be as it were
  48. a global from component to component ( up the nesting chain ).
  49. Then, the "OnPageBreakAfter" event will still be fired and the parameter
  50. "Aborted" tells whether or not the new page was aborted.
  51. Sorry I haven't provided a demonstration of a useful example on this feature.
  52. But, this is some pretty advanced stuff. . .
  53.  
  54. If you have any questions or comments please send an e-mail to the author:
  55.  
  56. Jason L. Wharton
  57. CServe:103757,763
  58.  
  59. or call ( if you must )
  60.  
  61. (602) 834-7454 (voice)
  62.  
  63.  
  64. NOTE:
  65.  
  66. There will be comprehensive documentation provided if enough positive
  67. feedback is received as a result of this sampling in the form of a
  68. commercial version.
  69.  
  70. This demo is not to be used for commercial use without obtaining a
  71. registered version from the author.
  72.  
  73. This package of files should not be distrubuted in any altered condition.
  74.  
  75. However, distribution of this origional package is highly encouraged.
  76. Especially since if user response is high a lower price will be affixed
  77. to the commercial version as confidence of acquiring large numbers of
  78. registered users increases.
  79.  
  80. So, go to work getting this around and see how cheap you can get the best
  81. ReportPrinter add-on product ever made!
  82.  
  83.  
  84.