.. wxPython Phoenix documentation This file was generated by Phoenix's sphinx generator and associated tools, do not edit by hand. Copyright: (c) 2011-2020 by Total Control Software License: wxWindows License .. include:: headings.inc .. _wx.PaintDC: ========================================================================================================================================== |phoenix_title| **wx.PaintDC** ========================================================================================================================================== A :ref:`wx.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:`wx.PaintDC` object. If you have an EVT_PAINT() handler, you `must` create a :ref:`wx.PaintDC` object within it even if you don't actually use it. Using :ref:`wx.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. A :ref:`wx.PaintDC` object is initialized to use the same font and colours as the window it is associated with. .. seealso:: :ref:`wx.DC`, :ref:`wx.ClientDC`, :ref:`wx.MemoryDC`, :ref:`wx.WindowDC`, :ref:`wx.ScreenDC` | |class_hierarchy| Class Hierarchy ================================= .. raw:: html
Inheritance diagram for class PaintDC:
| |method_summary| Methods Summary ================================ ================================================================================ ================================================================================ :meth:`~wx.PaintDC.__init__` Constructor. ================================================================================ ================================================================================ | |api| Class API =============== .. class:: wx.PaintDC(ClientDC) **Possible constructors**:: PaintDC(window) 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. .. method:: __init__(self, window) Constructor. Pass a pointer to the window on which you wish to paint. :param `window`: :type `window`: wx.Window