interface/dcprint.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        dcprint.h
   3 // Purpose:     interface of wxPrinterDC
   4 // Author:      wxWidgets team
   5 // RCS-ID:      $Id$
   6 // Licence:     wxWindows license
   7 /////////////////////////////////////////////////////////////////////////////
   8
   9 /**
  10     @class wxPrinterDC
  11     @wxheader{dcprint.h}
  12
  13     A printer device context is specific to MSW and Mac, and allows access to any
  14     printer with a Windows or Macintosh driver. See wxDC for further
  15     information on device contexts, and wxDC::GetSize for
  16     advice on achieving the correct scaling for the page.
  17
  18     @library{wxcore}
  19     @category{printing}
  20
  21     @see @ref overview_printingoverview "Printing framework overview", wxDC
  22 */
  23 class wxPrinterDC : public wxDC
  24 {
  25 public:
  26     //@{
  27     /**
  28         Constructor. With empty strings for the first three arguments, the default
  29         printer dialog is
  30         displayed. @a device indicates the type of printer and @e output
  31         is an optional file for printing to. The @a driver parameter is
  32         currently unused.  Use the @e Ok member to test whether the
  33         constructor was successful in creating a usable device context.
  34         This constructor is deprecated and retained only for backward compatibility.
  35     */
  36     wxPrinterDC(const wxPrintData& printData);
  37     wxPrinterDC(const wxString& driver, const wxString& device,
  38                 const wxString& output,
  39                 const bool interactive = true,
  40                 int orientation = wxPORTRAIT);
  41     //@}
  42
  43     /**
  44         Return the rectangle in device coordinates that corresponds to the full paper
  45         area, including the nonprinting regions of the paper. The point (0,0) in device
  46         coordinates is the top left corner of the page rectangle, which is the printable
  47         area on MSW and Mac. The coordinates of the top left corner of the paper
  48         rectangle will therefore have small negative values, while the bottom right
  49         coordinates will be somewhat larger than the values returned by
  50         wxDC::GetSize.
  51     */
  52     wxRect wxPrinterDC::GetPaperRect();
  53 };
  54