home *** CD-ROM | disk | FTP | other *** search
/ PC World Plus! (NZ) 2001 June / HDC50.iso / Runimage / Delphi50 / Doc / PRINTERS.INT < prev    next >
Text File  |  1999-08-11  |  5KB  |  108 lines
  1.  
  2. {*******************************************************}
  3. {                                                       }
  4. {       Borland Delphi Visual Component Library         }
  5. {                                                       }
  6. {       Copyright (c) 1995,99 Inprise Corporation       }
  7. {                                                       }
  8. {*******************************************************}
  9.  
  10. unit Printers;
  11.  
  12. {$R-,T-,X+,H+}
  13.  
  14. interface
  15.  
  16. uses Windows, WinSpool, SysUtils, Classes, Graphics, Forms;
  17.  
  18. type
  19.   EPrinter = class(Exception);
  20.  
  21.   { TPrinter }
  22.  
  23.   { The printer object encapsulates the printer interface of Windows.  A print
  24.     job is started whenever any redering is done either through a Text variable
  25.     or the printers canvas.  This job will stay open until EndDoc is called or
  26.     the Text variable is closed.  The title displayed in the Print Manager (and
  27.     on network header pages) is determined by the Title property.
  28.  
  29.     EndDoc - Terminates the print job (and closes the currently open Text).
  30.       The print job will being printing on the printer after a call to EndDoc.
  31.     NewPage - Starts a new page and increments the PageNumber property.  The
  32.       pen position of the Canvas is put back at (0, 0).
  33.     Canvas - Represents the surface of the currently printing page.  Note that
  34.       some printer do not support drawing pictures and the Draw, StretchDraw,
  35.       and CopyRect methods might fail.
  36.     Fonts - The list of fonts supported by the printer.  Note that TrueType
  37.       fonts appear in this list even if the font is not supported natively on
  38.       the printer since GDI can render them accurately for the printer.
  39.     PageHeight - The height, in pixels, of the page.
  40.     PageWidth - The width, in pixels, of the page.
  41.     PageNumber - The current page number being printed.  This is incremented
  42.       when ever the NewPage method is called.  (Note: This property can also be
  43.       incremented when a Text variable is written, a CR is encounted on the
  44.       last line of the page).
  45.     PrinterIndex - Specifies which printer in the TPrinters list that is
  46.       currently selected for printing.  Setting this property to -1 will cause
  47.       the default printer to be selected.  If this value is changed EndDoc is
  48.       called automatically.
  49.     Printers - A list of the printers installed in Windows.
  50.     Title - The title used by Windows in the Print Manager and for network
  51.       title pages. }
  52.  
  53.   TPrinterState = (psNoHandle, psHandleIC, psHandleDC);
  54.   TPrinterOrientation = (poPortrait, poLandscape);
  55.   TPrinterCapability = (pcCopies, pcOrientation, pcCollation);
  56.   TPrinterCapabilities = set of TPrinterCapability;
  57.  
  58.   TPrinter = class(TObject)
  59.   public
  60.     constructor Create;
  61.     destructor Destroy; override;
  62.     procedure Abort;
  63.     procedure BeginDoc;
  64.     procedure EndDoc;
  65.     procedure NewPage;
  66.     procedure GetPrinter(ADevice, ADriver, APort: PChar; var ADeviceMode: THandle);
  67.     procedure SetPrinter(ADevice, ADriver, APort: PChar; ADeviceMode: THandle);
  68.     procedure Refresh;
  69.     property Aborted: Boolean;
  70.     property Canvas: TCanvas;
  71.     property Capabilities: TPrinterCapabilities;
  72.     property Copies: Integer;
  73.     property Fonts: TStrings;
  74.     property Handle: HDC;
  75.     property Orientation: TPrinterOrientation;
  76.     property PageHeight: Integer;
  77.     property PageWidth: Integer;
  78.     property PageNumber: Integer;
  79.     property PrinterIndex: Integer;
  80.     property Printing: Boolean;
  81.     property Printers: TStrings;
  82.     property Title: string;
  83.   end;
  84.  
  85. { Printer function - Replaces the Printer global variable of previous versions,
  86.   to improve smart linking (reduce exe size by 2.5k in projects that don't use
  87.   the printer).  Code which assigned to the Printer global variable
  88.   must call SetPrinter instead.  SetPrinter returns current printer object
  89.   and makes the new printer object the current printer.  It is the caller's
  90.   responsibility to free the old printer, if appropriate.  (This allows
  91.   toggling between different printer objects without destroying configuration
  92.   settings.) }
  93.  
  94. function Printer: TPrinter;
  95. function SetPrinter(NewPrinter: TPrinter): TPrinter;
  96.  
  97. { AssignPrn - Assigns a Text variable to the currently selected printer.  Any
  98.   Write or Writeln's going to that file variable will be written on the
  99.   printer using the Canvas property's font.  A new page is automatically
  100.   started if a CR is encountered on (or a Writeln is written to) the last
  101.   line on the page.  Closing the text file will imply a call to the
  102.   Printer.EndDoc method. Note: only one Text variable can be open on the
  103.   printer at a time.  Opening a second will cause an exception.}
  104.  
  105. procedure AssignPrn(var F: Text);
  106.  
  107. implementation
  108.