From: Vadim Zeitlin <vadim@wxwidgets.org>
Date: Sat, 28 Apr 2012 22:24:31 +0000 (+0000)
Subject: Document that wxDCClipper currently resets clipping region.
X-Git-Url: https://git.saurik.com/wxWidgets.git/commitdiff_plain/586f402336c1054be3fef592b9a7109e85170d95

Document that wxDCClipper currently resets clipping region.

Unlike other similar classes, this one doesn't restore the previous clipping
region but just resets it because there is no way to get the current clipping
region from wxDC now. At least document this limitation until it can be fixed.

See #13834.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@71296 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---

diff --git a/interface/wx/dc.h b/interface/wx/dc.h
index e1f100f64c..e8e54c4526 100644
--- a/interface/wx/dc.h
+++ b/interface/wx/dc.h
@@ -1548,10 +1548,12 @@ public:
 /**
     @class wxDCClipper
 
-    wxDCClipper is a small helper class for setting a clipping region on a wxDC
-    and unsetting it automatically. An object of wxDCClipper class is typically
-    created on the stack so that it is automatically destroyed when the object
-    goes out of scope. A typical usage example:
+    wxDCClipper is a helper class for setting a clipping region on a wxDC
+    during its lifetime.
+
+    An object of wxDCClipper class is typically created on the stack so that it
+    is automatically destroyed when the object goes out of scope. A typical
+    usage example:
 
     @code
     void MyFunction(wxDC& dc)
@@ -1568,6 +1570,12 @@ public:
     }
     @endcode
 
+    @note Unlike other similar classes such as wxDCFontChanger, wxDCClipper
+        currently doesn't restore the previously active clipping region when it
+        is destroyed but simply resets clipping on the associated wxDC. This
+        may be changed in the future wxWidgets versions but has to be taken
+        into account explicitly in the current one.
+
     @library{wxcore}
     @category{gdi}