Document that wxEraseEvent::GetDC() never returns NULL.

This makes implementation of EVT_ERASE_BACKGROUND handlers simpler.

Closes #13736.

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

diff --git a/interface/wx/event.h b/interface/wx/event.h
index afc71acc7d9475c05df70a656d93e3c7595c2f5d..31b9606d717f418f911324918cc78e8a954fb1a8 100644 (file)
--- a/interface/wx/event.h
+++ b/interface/wx/event.h
@@ -2852,12 +2852,8 @@ public:
     To intercept this event, use the EVT_ERASE_BACKGROUND macro in an event table
     definition.
 
     To intercept this event, use the EVT_ERASE_BACKGROUND macro in an event table
     definition.
 

-    You must call wxEraseEvent::GetDC and use the returned device context if it is
-    non-@NULL. If it is @NULL, create your own temporary wxClientDC object.
-
-    @remarks
-        Use the device context returned by GetDC to draw on, don't create
-        a wxPaintDC in the event handler.
+    You must use the device context returned by GetDC() to draw on, don't create
+    a wxPaintDC in the event handler.

 
     @beginEventTable{wxEraseEvent}
     @event{EVT_ERASE_BACKGROUND(func)}
 
     @beginEventTable{wxEraseEvent}
     @event{EVT_ERASE_BACKGROUND(func)}


@@ -2879,6 +2875,8 @@ public:
 
     /**
         Returns the device context associated with the erase event to draw on.
 
     /**
         Returns the device context associated with the erase event to draw on.

+
+        The returned pointer is never @NULL.

     */
     wxDC* GetDC() const;
 };
     */
     wxDC* GetDC() const;
 };