.. 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.DCClipper: ========================================================================================================================================== |phoenix_title| **wx.DCClipper** ========================================================================================================================================== :ref:`wx.DCClipper` is a helper class for setting a clipping region on a :ref:`wx.DC` during its lifetime. An object of :ref:`wx.DCClipper` class is typically created on the stack so that it is automatically destroyed when the object goes out of scope. A typical usage example: :: def MyFunction(dc): clip = wx.DCClipper(dc, rect) # ... drawing functions here are affected by clipping rect ... def OtherFunction(): dc = wx.DC() MyFunction(dc) # ... drawing functions here are not affected by clipping rect ... .. note:: Since 3.1.1 :ref:`wx.DCClipper` restores the previously active clipping region when it is destroyed. Previously it reset clipping on the associated :ref:`wx.DC` and this has to be taken into account explicitly in previous wxWidgets versions. .. seealso:: :meth:`wx.DC.SetClippingRegion` , :ref:`wx.DCFontChanger`, :ref:`wx.DCTextColourChanger`, :ref:`wx.DCPenChanger`, :ref:`wx.DCBrushChanger` | |class_hierarchy| Class Hierarchy ================================= .. raw:: html