- // this function should return the brush to paint the window background
- // with or 0 for the default brush
- virtual WXHBRUSH OnCtlColor(WXHDC hDC,
- WXHWND hWnd,
- WXUINT nCtlColor,
- WXUINT message,
- WXWPARAM wParam,
- WXLPARAM lParam);
+ // this function should return the brush to paint the children controls
+ // background or 0 if this window doesn't impose any particular background
+ // on its 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, WXHWND hWnd);
+
+ // return the background brush to use for painting the given window by
+ // quering the parent windows via their MSWGetBgBrushForChild() recursively
+ //
+ // hWndToPaint is normally NULL meaning this window itself, but it can also
+ // be a child of this window which is used by the static box and could be
+ // potentially useful for other transparent controls
+ WXHBRUSH MSWGetBgBrush(WXHDC hDC, WXHWND hWndToPaint = NULL);
+
+ // 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()
+ {
+ return true;
+ }