X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/e0de65e8b8edb5d56c75e1af1fb99e19301df796..4c16bedf179acf883041b6fcede0a430ddf34022:/wxPython/src/_renderer.i

diff --git a/wxPython/src/_renderer.i b/wxPython/src/_renderer.i
index c86aad1d01..f95f1ea916 100644
--- a/wxPython/src/_renderer.i
+++ b/wxPython/src/_renderer.i
@@ -112,6 +112,11 @@ The wx.RendererNative class is a collection of functions that have
 platform-specific implementations for drawing certain parts of
 genereic controls in ways that are as close to the native look as
 possible.
+
+Note that each drawing function restores the `wx.DC` attributes if it
+changes them, so it is safe to assume that the same pen, brush and
+colours that were active before the call to this function are still in
+effect after it.
 ", "");
 
 class wxRendererNative
@@ -184,14 +189,41 @@ you need. ``flags`` may have the ``wx.CONTROL_PRESSED`` or
     
 
     DocDeclStr(
-        virtual void , DrawCheckButton(wxWindow *win,
-                                       wxDC& dc,
-                                       const wxRect& rect,
-                                       int flags = 0),
+        virtual void , DrawCheckBox(wxWindow *win,
+                                    wxDC& dc,
+                                    const wxRect& rect,
+                                    int flags = 0),
         "Draw a check button.  Flags may use wx.CONTROL_CHECKED,
 wx.CONTROL_UNDETERMINED and wx.CONTROL_CURRENT.", "");
     
 
+    DocDeclStr(
+        virtual void , DrawPushButton(wxWindow *win,
+                                      wxDC& dc,
+                                      const wxRect& rect,
+                                      int flags = 0),
+        "Draw a blank button.  Flags may be wx.CONTROL_PRESSED, wx.CONTROL_CURRENT and
+wx.CONTROL_ISDEFAULT", "");
+    
+
+    DocDeclStr(
+        virtual void , DrawItemSelectionRect(wxWindow *win,
+                                             wxDC& dc,
+                                             const wxRect& rect,
+                                             int flags = 0),
+        "Draw rectangle indicating that an item in e.g. a list control has been
+selected or focused
+
+The flags parameter may be:
+
+    ====================  ============================================
+    wx.CONTROL_SELECTED   item is selected, e.g. draw background
+    wx.CONTROL_CURRENT    item is the current item, e.g. dotted border
+    wx.CONTROL_FOCUSED    the whole control has focus, e.g. blue
+                          background vs. grey otherwise
+    ====================  ============================================
+", "");
+    
     
     DocDeclStr(
         virtual wxSplitterRenderParams , GetSplitterParams(const wxWindow *win),
@@ -199,12 +231,13 @@ wx.CONTROL_UNDETERMINED and wx.CONTROL_CURRENT.", "");
     
 
 
-
+    MustHaveApp(Get);
     DocDeclStr(
         static wxRendererNative& , Get(),
         "Return the currently used renderer", "");
     
 
+    MustHaveApp(GetGeneric);
     DocDeclStr(
         static wxRendererNative& , GetGeneric(),
         "Return the generic implementation of the renderer. Under some
@@ -213,6 +246,7 @@ platform-specific default renderer which can be retrieved by calling
 `GetDefault`.", "");
     
 
+    MustHaveApp(GetDefault);
     DocDeclStr(
         static wxRendererNative& , GetDefault(),
         "Return the default (native) implementation for this platform -- this
@@ -228,6 +262,7 @@ the return value of `Get`.", "");
 //     static wxRendererNative *Load(const wxString& name);
 
 
+    MustHaveApp(Set);
     DocDeclStr(
         static wxRendererNative *, Set(wxRendererNative *renderer),
         "Set the renderer to use, passing None reverts to using the default