.. include:: headings.inc



.. _PrinterDC:

==========================================================================================================================================
|phoenix_title|  **PrinterDC**
==========================================================================================================================================

A printer device context is specific to MSW and Mac, and allows access to any printer with a Windows or Macintosh driver.          

See :ref:`DC`  for further information on device contexts, and :meth:`DC.GetSize`   for advice on achieving the correct scaling for the page. 







         



.. seealso:: :ref:`Printing Framework Overview <printing framework overview>`, :ref:`DC`    







|

|class_hierarchy| Inheritance Diagram
=====================================

Inheritance diagram for class **PrinterDC**

.. raw:: html

   <p class="graphviz">
   <img src="_static/images/inheritance/PrinterDC_inheritance.png" alt="Inheritance diagram of PrinterDC" usemap="#dummy" class="inheritance"/>
   <map id="dummy" name="dummy"> <area shape="rect" id="node1" href="Object.html" title="This is the root class of many of the wxWidgets classes." alt="" coords="5,5,77,35"/> <area shape="rect" id="node2" href="DC.html" title="A DC  is a `'device context'`  onto which graphics and text can be drawn." alt="" coords="125,5,197,35"/> <area shape="rect" id="node4" href="PrinterDC.html" title="A printer device context is specific to MSW and Mac, and allows access to any printer with a Windows or Macintosh driver." alt="" coords="247,5,340,35"/> </map> 
   </p>

|


|method_summary| Methods Summary
================================

================================================================================ ================================================================================
:meth:`~PrinterDC.__init__`                                                      Constructor.
:meth:`~PrinterDC.GetPaperRect`                                                  Return the rectangle in device coordinates that corresponds to the full paper area, including the nonprinting regions of the paper.
================================================================================ ================================================================================


|


|property_summary| Properties Summary
=====================================

================================================================================ ================================================================================
:attr:`~PrinterDC.PaperRect`                                                     See :meth:`~PrinterDC.GetPaperRect`
================================================================================ ================================================================================


|


|api| Class API
===============
   

.. class:: PrinterDC(DC)

   A printer device context is specific to MSW and Mac, and allows access to any printer with a Windows or Macintosh driver.
   
   **Possible constructors**::

       PrinterDC(printData)
       



   .. method:: __init__(self, printData)

      Constructor.                  

      Pass a :ref:`PrintData`  object with information necessary for setting up a suitable printer device context. This is the recommended way to construct a :ref:`PrinterDC`. Make sure you specify a reference to a :ref:`PrintData`  object, not a pointer - you may not even get a warning if you pass a pointer instead.                  


      :param `printData`: 
      :type `printData`: PrintData







   .. method:: GetPaperRect(self)

      Return the rectangle in device coordinates that corresponds to the full paper area, including the nonprinting regions of the paper.                  

      The point (0,0) in device coordinates is the top left corner of the page rectangle, which is the printable area on MSW and Mac. The coordinates of the top left corner of the paper rectangle will therefore have small negative values, while the bottom right coordinates will be somewhat larger than the values returned by :meth:`DC.GetSize` .                  

      :rtype: :ref:`Rect`








   .. attribute:: PaperRect

      See :meth:`~PrinterDC.GetPaperRect`