.. wxPython Phoenix documentation

   This file was generated by Phoenix's sphinx generator and associated
   tools, do not edit by hand.

   Copyright: (c) 2011-2025 by Total Control Software
   License:   wxWindows License

.. include:: headings.inc



.. _wx.WindowDC:

==========================================================================================================================================
|phoenix_title|  **wx.WindowDC**
==========================================================================================================================================

Deprecated class for drawing on the entire window. 
         

Please don't use this class in the new code, as it doesn't work on modern systems any longer and using it is not guaranteed to have any effect at all. 

A :ref:`wx.WindowDC`  must be constructed if an application wishes to paint on the whole area of a window (client and decorations). This should normally be constructed as a temporary stack object; don't store a :ref:`wx.WindowDC`  object. 

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

To draw on the client area of a window from outside an EVT_PAINT() handler, construct a :ref:`wx.ClientDC`  object. 

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








         



.. seealso:: :ref:`wx.DC`, :ref:`wx.MemoryDC`, :ref:`wx.PaintDC`, :ref:`wx.ClientDC`    







|

|class_hierarchy| Class Hierarchy
=================================

.. raw:: html

   <div class="collabsible-wrapper">
      <input id="collapsible-inheritance" class="collapsible-checkbox" type="checkbox">
      <label for="collapsible-inheritance" tabindex="0" title="Show inheritance diagram" class="collapsible-label">Inheritance diagram for class <strong>WindowDC</strong>:</label>
      <div class="collapsible-content">
         <p class="graphviz">
            <center><img src="_static/images/inheritance/wx.WindowDC_inheritance.svg" alt="Inheritance diagram of WindowDC" usemap="#dummy" class="inheritance invert-in-dark-mode"/></center>
            <map id="dummy" name="dummy"> <area shape="rect" id="node1" href="wx.WindowDC.html" title="Deprecated class for drawing on the entire window." alt="" coords="12,236,147,265"/> <area shape="rect" id="node2" href="wx.DC.html" title="A wx.DC  is a `'device context'`  onto which graphics and text can be drawn." alt="" coords="41,159,118,188"/> <area shape="rect" id="node3" href="wx.ReadOnlyDC.html" title="Base class for device context not providing any drawing functions." alt="" coords="5,82,154,111"/> <area shape="rect" id="node4" href="wx.Object.html" title="This is the root class of many of the wxWidgets classes." alt="" coords="30,5,129,34"/> </map> 
         </p>
      </div>
   </div>
   <script type="text/javascript" src="_static/inheritancetoggle.js"></script>



|


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

:ref:`wx.ClientDC`

|


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

================================================================================ ================================================================================
:meth:`~wx.WindowDC.__init__`                                                    Constructor.
================================================================================ ================================================================================


|


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


.. class:: wx.WindowDC(DC)

   **Possible constructors**::

       WindowDC(window) -> None
       
   
   Deprecated class for drawing on the entire window.



   .. method:: __init__(self, window)

      Constructor. 
                 

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


      :param `window`: 
      :type `window`: wx.Window




      :rtype: `None`