.. include:: headings.inc



.. _PaintDC:

==========================================================================================================================================
|phoenix_title|  **PaintDC**
==========================================================================================================================================

A :ref:`PaintDC`  must be constructed if an application wishes to paint on the client area of a window from within an EVT_PAINT() event handler.          

This should normally be constructed as a temporary stack object; don't store a :ref:`PaintDC`  object. If you have an EVT_PAINT() handler, you `must`  create a :ref:`PaintDC`  object within it even if you don't actually use it. 

Using :ref:`PaintDC`  within your EVT_PAINT() handler is important because it automatically sets the clipping area to the damaged area of the window. Attempts to draw outside this area do not appear. 

To draw on a window from outside your EVT_PAINT() handler, construct a :ref:`ClientDC`  object. 

To draw on the whole window including decorations, construct a :ref:`WindowDC`  object (Windows only). 

A :ref:`PaintDC`  object is initialized to use the same font and colours as the window it is associated with. 







         



.. seealso:: :ref:`DC`, :ref:`ClientDC`, :ref:`MemoryDC`, :ref:`WindowDC`, :ref:`ScreenDC`    







|

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

Inheritance diagram for class **PaintDC**

.. raw:: html

   <p class="graphviz">
   <img src="_static/images/inheritance/PaintDC_inheritance.png" alt="Inheritance diagram of PaintDC" usemap="#dummy" class="inheritance"/>
   <map id="dummy" name="dummy"> <area shape="rect" id="node1" href="WindowDC.html" title="A WindowDC  must be constructed if an application wishes to paint on the whole area of a window (client and decorations)." alt="" coords="247,5,351,35"/> <area shape="rect" id="node5" href="ClientDC.html" title="A ClientDC  must be constructed if an application wishes to paint on the client area of a window from outside an EVT_PAINT() handler." alt="" coords="401,5,487,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="PaintDC.html" title="A PaintDC  must be constructed if an application wishes to paint on the client area of a window from within an EVT_PAINT() event handler." alt="" coords="536,5,619,35"/> <area shape="rect" id="node7" href="Object.html" title="This is the root class of many of the wxWidgets classes." alt="" coords="5,5,77,35"/> </map> 
   </p>

|


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

================================================================================ ================================================================================
:meth:`~PaintDC.__init__`                                                        Constructor.
================================================================================ ================================================================================


|


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

.. class:: PaintDC(ClientDC)

   A PaintDC must be constructed if an application wishes to paint on the client area of a window from within an EVT_PAINT() event handler.
   
   **Possible constructors**::

       PaintDC(window)
       



   .. method:: __init__(self, window)

      Constructor.                  

      Pass a pointer to the window on which you wish to paint.                  


      :param `window`: 
      :type `window`: Window