- // the base class version uses MSWGetBgColourForChild() and returns a solid
- // brush if we have a non default background colour or 0 otherwise
- virtual WXHBRUSH MSWGetBgBrushForChild(WXHDC WXUNUSED(hDC), wxWindow *child)
+ // the hDC parameter is the DC background will be drawn on, it can be used
+ // to call SetBrushOrgEx() on it if the returned brush is a bitmap one
+ //
+ // child parameter is never NULL, it can be this window itself or one of
+ // its (grand)children
+ //
+ // the base class version returns a solid brush if we have a non default
+ // background colour or 0 otherwise
+ virtual WXHBRUSH MSWGetBgBrushForChild(WXHDC hDC, wxWindowMSW *child);
+
+ // return the background brush to use for painting the given window by
+ // querying the parent windows via MSWGetBgBrushForChild() recursively
+ WXHBRUSH MSWGetBgBrush(WXHDC hDC);
+
+ enum MSWThemeColour
+ {
+ ThemeColourText = 0,
+ ThemeColourBackground,
+ ThemeColourBorder
+ };
+
+ // returns a specific theme colour, or if that is not possible then
+ // wxSystemSettings::GetColour(fallback)
+ wxColour MSWGetThemeColour(const wchar_t *themeName,
+ int themePart,
+ int themeState,
+ MSWThemeColour themeColour,
+ wxSystemColour fallback) const;
+
+ // gives the parent the possibility to draw its children background, e.g.
+ // this is used by wxNotebook to do it using DrawThemeBackground()
+ //
+ // return true if background was drawn, false otherwise
+ virtual bool MSWPrintChild(WXHDC WXUNUSED(hDC), wxWindow * WXUNUSED(child))
+ {
+ return false;
+ }
+
+ // some controls (e.g. wxListBox) need to set the return value themselves
+ //
+ // return true to let parent handle it if we don't, false otherwise
+ virtual bool MSWShouldPropagatePrintChild()