NOTE: This document is also provided as a Windows 3.1 Write file with formatting. ******************************* *** Print Preview Component *** ******************************* Adds *easy* Print Preview capability to any Delphi Application Features: Print Preview supports: - Zoom from 10% to 5000% - Zoom tool allows zoom in/out on a specific location - Hand tool allows easy panning across the page - One Page or Two Page displays - Portrait or Landscape page orientation - Printing Status display with CANCEL and cooperative multi-tasking - Tool Tips & Hints for iconic buttons - Status bar displays page, zoom level, and hints - Customizable Grid verifies margins & layout Programmer Benefits: - One set of routines for Printing & Previewing - Supports all TCanvas routines (except for PenPos & Pixels) - Built-in routines eliminate round-off errors for pagination - Automatically clips non printable area on Preview - Returns the true physical page size (not just printable area) - Returns all printer info (page size, printable area, pixels/inch, etc) - Conversion routines for inches to printer units - All Preview Screen scaling performed automatically - Programmer can implement Exception Handling to catch Print Preview Errors - Simple & Advanced print pagination is supported - Customizable Preview Form - Show/hide buttons - Change the title - Select min, max, and step for Zooming - Set initial settings Fully functional - not crippled in any way The unregistered version of this component has an "About" box on the Preview screen that indicates the component has not been registered. Installation 1. Copy the files PRNTPREV.DCU, PRNTPREV.DCR, *.DFM, and *.RES to your DELPHI\LIB directory. 2. From the "Options" Menu, select "Install Components". Press the "Add" button, and then the "Browse" button. Go to the LIB directory, and select UNIT file types (*.dcu). Then select PRNTPREV.DCU and press "OK". Then press "OK" for the Install Components dialog box. 3. When Delphi is done compiling there will be a new component in your "Samples" palette called PrintPreview. Testing the Print Preview Component A sample project is already provided. Open the project called TESTPREV.DPR and run it. Note: you must install the Print Preview component before opening and running the test project. When the program starts, you are given four page tab control (Text, Table, Graphics, and MultiPage). Select each page and press the Print Preview button to view the demo. You may change some of the options for each of the examples. Once inside the Print Preview screen, you can zoom in or out (with the buttons or by clicking with the mouse). The Hand tool can be used to move the page around (only if it is larger than the screen). You can select a one page or two page view. In the MultiPage example, you can advance to the next page, or move back. Advanced To use the Print Preview component in your own projects, simply drop the component on your form. Then register the three events (Begin Print, End Print, and Print Page) with your own routines. Refer to the Test project sample code, or to the PRNTPREV.INT file for technical details on interfacing with the component. The sample project code shows 90% of what can be done with the component. Shareware Registration This component is shareware, and is distributed to be used for a limited trial period of 30 days. You are free to copy and distribute this software in unmodified form. After the 30 day period the software should be registered or removed from the user's system. If the component is to be included in a commercial or government application, it must be registered (i.e., paid for). The registered version of the component offers two additional benefits: 1) the ability to hide the "About" box on the Preview screen, or replacing it with your own custom button & procedure; and 2) technical support via email or phone (you pay the long distance though). Source code is also available to registered users. Pricing and Ordering Information Registered Print Preview is U.S. $20. Full source code is an additional $20. If you need a 3.5" disk mailed to you, an additional $4 is charged for shipping and handling. Preferrable, if you have email I can just email you the registered component (and source code). Send a check or money order to: Print Preview Component Software Care of: Ben Ziegler 210 E. Fairfax St #624 Falls Church, VA 22046 Make checks payable to "Ben Ziegler." When you register I will send you my phone number for technical support. Note that I can only take calls after work. Questions, Comments, and Suggestions I'd love to hear any questions, comments, or suggestions you may have (and yes, even bug reports). I can also be reached on email at benz23@aol.com. Thanks for trying my Print Preview component! Delphi Rules!! -Ben