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
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),
-
+ 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`.", "");
// 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