Various updates

[wxWidgets.git] / wxPython / src / _renderer.i

diff --git a/wxPython/src/_renderer.i b/wxPython/src/_renderer.i
index 938575e6296663fdc7b2a7a8d460033c0d529a9a..3ee0740e0f6ac29ca9e634c688623de46397ddbf 100644 (file)
--- 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
@@ -124,7 +129,7 @@ public:
                                         wxDC& dc,
                                         const wxRect& rect,
                                         int flags = 0),
-        "Draw the header control button (such as whar is used by `wx.ListCtrl`
+        "Draw the header control button (such as what is used by `wx.ListCtrl`
 in report mode.)", "");
     
 
@@ -183,33 +188,71 @@ you need. ``flags`` may have the ``wx.CONTROL_PRESSED`` or
 ``wx.CONTROL_CURRENT`` bit set.", "");
     
 
+    DocDeclStr(
+        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),
         "Get the splitter parameters, see `wx.SplitterRenderParams`.", "");
     
 
 
-
+    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
 platforms, this is the default renderer implementation, others have
 platform-specific default renderer which can be retrieved by calling
-`GetDefault`.", "");
+`wx.RendererNative.GetDefault`.", "");
     
 
+    MustHaveApp(GetDefault);
     DocDeclStr(
         static wxRendererNative& , GetDefault(),
         "Return the default (native) implementation for this platform -- this
-is also the one used by default but this may be changed by calling `Set`
-in which case the return value of this method may be different from
-the return value of `Get`.", "");
+is also the one used by default but this may be changed by calling
+`wx.RendererNative.Set` in which case the return value of this method
+may be different from the return value of `wx.RendererNative.Get`.", "");
     
 
 
@@ -219,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