.. include:: headings.inc



.. _ClientDC:

==========================================================================================================================================
|phoenix_title|  **ClientDC**
==========================================================================================================================================

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

This should normally be constructed as a temporary stack object; don't store a :ref:`ClientDC`  object. 

To draw on a window from within an EVT_PAINT() handler, construct a :ref:`PaintDC`  object instead. 

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

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







         



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







|

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

Inheritance diagram for class **ClientDC**

.. raw:: html

   <p class="graphviz">
   <img src="_static/images/inheritance/ClientDC_inheritance.png" alt="Inheritance diagram of ClientDC" 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="Object.html" title="This is the root class of many of the wxWidgets classes." alt="" coords="5,5,77,35"/> </map> 
   </p>

|


|sub_classes| Known Subclasses
==============================

:ref:`PaintDC`

|


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

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


|


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

.. class:: ClientDC(WindowDC)

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

       ClientDC(window)
       



   .. method:: __init__(self, window)

      Constructor.                  

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


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