src/msw/statbox.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        msw/statbox.cpp
   3 // Purpose:     wxStaticBox
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     04/01/98
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
  21     #pragma implementation "statbox.h"
  22 #endif
  23
  24 // For compilers that support precompilation, includes "wx.h".
  25 #include "wx/wxprec.h"
  26
  27 #ifdef __BORLANDC__
  28     #pragma hdrstop
  29 #endif
  30
  31 #if wxUSE_STATBOX
  32
  33 #ifndef WX_PRECOMP
  34     #include "wx/app.h"
  35     #include "wx/dcclient.h"
  36 #endif
  37
  38 #include "wx/statbox.h"
  39 #include "wx/notebook.h"
  40 #include "wx/sysopt.h"
  41 #include "wx/image.h"
  42 #include "wx/dcmemory.h"
  43 #include "wx/sysopt.h"
  44
  45 #include "wx/msw/uxtheme.h"
  46 #include "wx/msw/private.h"
  47 #include "wx/msw/missing.h"
  48
  49 // ----------------------------------------------------------------------------
  50 // wxWin macros
  51 // ----------------------------------------------------------------------------
  52
  53 #if wxUSE_EXTENDED_RTTI
  54 WX_DEFINE_FLAGS( wxStaticBoxStyle )
  55
  56 wxBEGIN_FLAGS( wxStaticBoxStyle )
  57     // new style border flags, we put them first to
  58     // use them for streaming out
  59     wxFLAGS_MEMBER(wxBORDER_SIMPLE)
  60     wxFLAGS_MEMBER(wxBORDER_SUNKEN)
  61     wxFLAGS_MEMBER(wxBORDER_DOUBLE)
  62     wxFLAGS_MEMBER(wxBORDER_RAISED)
  63     wxFLAGS_MEMBER(wxBORDER_STATIC)
  64     wxFLAGS_MEMBER(wxBORDER_NONE)
  65
  66     // old style border flags
  67     wxFLAGS_MEMBER(wxSIMPLE_BORDER)
  68     wxFLAGS_MEMBER(wxSUNKEN_BORDER)
  69     wxFLAGS_MEMBER(wxDOUBLE_BORDER)
  70     wxFLAGS_MEMBER(wxRAISED_BORDER)
  71     wxFLAGS_MEMBER(wxSTATIC_BORDER)
  72     wxFLAGS_MEMBER(wxBORDER)
  73
  74     // standard window styles
  75     wxFLAGS_MEMBER(wxTAB_TRAVERSAL)
  76     wxFLAGS_MEMBER(wxCLIP_CHILDREN)
  77     wxFLAGS_MEMBER(wxTRANSPARENT_WINDOW)
  78     wxFLAGS_MEMBER(wxWANTS_CHARS)
  79     wxFLAGS_MEMBER(wxFULL_REPAINT_ON_RESIZE)
  80     wxFLAGS_MEMBER(wxALWAYS_SHOW_SB )
  81     wxFLAGS_MEMBER(wxVSCROLL)
  82     wxFLAGS_MEMBER(wxHSCROLL)
  83
  84 wxEND_FLAGS( wxStaticBoxStyle )
  85
  86 IMPLEMENT_DYNAMIC_CLASS_XTI(wxStaticBox, wxControl,"wx/statbox.h")
  87
  88 wxBEGIN_PROPERTIES_TABLE(wxStaticBox)
  89     wxPROPERTY( Label,wxString, SetLabel, GetLabel, wxString() , 0 /*flags*/ , wxT("Helpstring") , wxT("group"))
  90     wxPROPERTY_FLAGS( WindowStyle , wxStaticBoxStyle , long , SetWindowStyleFlag , GetWindowStyleFlag , EMPTY_MACROVALUE, 0 /*flags*/ , wxT("Helpstring") , wxT("group")) // style
  91 /*
  92     TODO PROPERTIES :
  93         label
  94 */
  95 wxEND_PROPERTIES_TABLE()
  96
  97 wxBEGIN_HANDLERS_TABLE(wxStaticBox)
  98 wxEND_HANDLERS_TABLE()
  99
 100 wxCONSTRUCTOR_6( wxStaticBox , wxWindow* , Parent , wxWindowID , Id , wxString , Label , wxPoint , Position , wxSize , Size , long , WindowStyle )
 101 #else
 102 IMPLEMENT_DYNAMIC_CLASS(wxStaticBox, wxControl)
 103 #endif
 104
 105 // ============================================================================
 106 // implementation
 107 // ============================================================================
 108
 109 // ----------------------------------------------------------------------------
 110 // wxStaticBox
 111 // ----------------------------------------------------------------------------
 112
 113 bool wxStaticBox::Create(wxWindow *parent,
 114                          wxWindowID id,
 115                          const wxString& label,
 116                          const wxPoint& pos,
 117                          const wxSize& size,
 118                          long style,
 119                          const wxString& name)
 120 {
 121     if ( !CreateControl(parent, id, pos, size, style, wxDefaultValidator, name) )
 122         return false;
 123
 124     if ( !MSWCreateControl(wxT("BUTTON"), label, pos, size) )
 125         return false;
 126
 127 #ifndef __WXWINCE__
 128     if (!wxSystemOptions::IsFalse(wxT("msw.staticbox.optimized-paint")))
 129         Connect(wxEVT_PAINT, wxPaintEventHandler(wxStaticBox::OnPaint));
 130 #endif // !__WXWINCE__
 131
 132     return true;
 133 }
 134
 135 wxBorder wxStaticBox::GetDefaultBorder() const
 136 {
 137     return wxBORDER_NONE;
 138 }
 139
 140 WXDWORD wxStaticBox::MSWGetStyle(long style, WXDWORD *exstyle) const
 141 {
 142     long styleWin = wxStaticBoxBase::MSWGetStyle(style, exstyle);
 143
 144     // no need for it anymore, must be removed for wxRadioBox child
 145     // buttons to be able to repaint themselves
 146     styleWin &= ~WS_CLIPCHILDREN;
 147
 148     if ( exstyle )
 149     {
 150 #ifndef __WXWINCE__
 151         if (wxSystemOptions::IsFalse(wxT("msw.staticbox.optimized-paint")))
 152             *exstyle = WS_EX_TRANSPARENT;
 153         else
 154 #endif
 155             *exstyle = 0;
 156     }
 157
 158     return styleWin | BS_GROUPBOX;
 159 }
 160
 161 wxSize wxStaticBox::DoGetBestSize() const
 162 {
 163     int cx, cy;
 164     wxGetCharSize(GetHWND(), &cx, &cy, GetFont());
 165
 166     int wBox;
 167     GetTextExtent(wxGetWindowText(m_hWnd), &wBox, &cy);
 168
 169     wBox += 3*cx;
 170     int hBox = EDIT_HEIGHT_FROM_CHAR_HEIGHT(cy);
 171
 172     wxSize best(wBox, hBox);
 173     CacheBestSize(best);
 174     return best;
 175 }
 176
 177 void wxStaticBox::GetBordersForSizer(int *borderTop, int *borderOther) const
 178 {
 179     wxStaticBoxBase::GetBordersForSizer(borderTop, borderOther);
 180
 181     // need extra space, don't know how much but this seems to be enough
 182     *borderTop += GetCharHeight()/3;
 183 }
 184
 185 // all the hacks below are not necessary for WinCE
 186 #ifndef __WXWINCE__
 187
 188 WXLRESULT wxStaticBox::MSWWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam)
 189 {
 190     if ( nMsg == WM_NCHITTEST )
 191     {
 192         // This code breaks some other processing such as enter/leave tracking
 193         // so it's off by default.
 194
 195         static int s_useHTClient = -1;
 196         if (s_useHTClient == -1)
 197             s_useHTClient = wxSystemOptions::GetOptionInt(wxT("msw.staticbox.htclient"));
 198         if (s_useHTClient == 1)
 199         {
 200             int xPos = GET_X_LPARAM(lParam);
 201             int yPos = GET_Y_LPARAM(lParam);
 202
 203             ScreenToClient(&xPos, &yPos);
 204
 205             // Make sure you can drag by the top of the groupbox, but let
 206             // other (enclosed) controls get mouse events also
 207             if ( yPos < 10 )
 208                 return (long)HTCLIENT;
 209         }
 210     }
 211
 212     if ( nMsg == WM_PRINTCLIENT )
 213     {
 214         // we have to process WM_PRINTCLIENT ourselves as otherwise child
 215         // windows' background (eg buttons in radio box) would never be drawn
 216         // unless we have a parent with non default background
 217
 218         // so check first if we have one
 219         if ( !HandlePrintClient((WXHDC)wParam) )
 220         {
 221             // no, we don't, erase the background ourselves
 222             // (don't use our own) - see PaintBackground for explanation
 223             wxBrush brush(GetParent()->GetBackgroundColour());
 224             wxFillRect(GetHwnd(), (HDC)wParam, GetHbrushOf(brush));
 225         }
 226
 227         return 0;
 228     }
 229
 230     return wxControl::MSWWindowProc(nMsg, wParam, lParam);
 231 }
 232
 233 // ----------------------------------------------------------------------------
 234 // static box drawing
 235 // ----------------------------------------------------------------------------
 236
 237 /*
 238    We draw the static box ourselves because it's the only way to prevent it
 239    from flickering horribly on resize (because everything inside the box is
 240    erased twice: once when the box itself is repainted and second time when
 241    the control inside it is repainted) without using WS_EX_TRANSPARENT style as
 242    we used to do and which resulted in other problems.
 243  */
 244
 245 // MSWGetRegionWithoutSelf helper: removes the given rectangle from region
 246 static inline void
 247 SubtractRectFromRgn(HRGN hrgn, int left, int top, int right, int bottom)
 248 {
 249     AutoHRGN hrgnRect(::CreateRectRgn(left, top, right, bottom));
 250     if ( !hrgnRect )
 251     {
 252         wxLogLastError(_T("CreateRectRgn()"));
 253         return;
 254     }
 255
 256     ::CombineRgn(hrgn, hrgn, hrgnRect, RGN_DIFF);
 257 }
 258
 259 void wxStaticBox::MSWGetRegionWithoutSelf(WXHRGN hRgn, int w, int h)
 260 {
 261     HRGN hrgn = (HRGN)hRgn;
 262
 263     // remove the area occupied by the static box borders from the region
 264     int borderTop, border;
 265     GetBordersForSizer(&borderTop, &border);
 266
 267     // top
 268     SubtractRectFromRgn(hrgn, 0, 0, w, borderTop);
 269
 270     // bottom
 271     SubtractRectFromRgn(hrgn, 0, h - border, w, h);
 272
 273     // left
 274     SubtractRectFromRgn(hrgn, 0, 0, border, h);
 275
 276     // right
 277     SubtractRectFromRgn(hrgn, w - border, 0, w, h);
 278 }
 279
 280 WXHRGN wxStaticBox::MSWGetRegionWithoutChildren()
 281 {
 282     RECT rc;
 283     ::GetWindowRect(GetHwnd(), &rc);
 284     HRGN hrgn = ::CreateRectRgn(rc.left, rc.top, rc.right + 1, rc.bottom + 1);
 285
 286     // iterate over all child windows (not just wxWindows but all windows)
 287     for ( HWND child = ::GetWindow(GetHwndOf(GetParent()), GW_CHILD);
 288           child;
 289           child = ::GetWindow(child, GW_HWNDNEXT) )
 290     {
 291         if ( ! ::IsWindowVisible(child) )
 292         {
 293             // if the window isn't visible then it doesn't need clipped
 294             continue;
 295         }
 296
 297         LONG style = ::GetWindowLong(child, GWL_STYLE);
 298         wxString str(wxGetWindowClass(child));
 299         str.UpperCase();
 300         if ( str == wxT("BUTTON") && (style & BS_GROUPBOX) == BS_GROUPBOX )
 301         {
 302             // Don't clip any static boxes, not just this one.  This will
 303             // result in flicker in overlapping static boxes, but at least
 304             // they will all be drawn correctly and we shouldn't have
 305             // overlapping windows anyway.
 306             continue;
 307         }
 308
 309         ::GetWindowRect(child, &rc);
 310         if ( ::RectInRegion(hrgn, &rc) )
 311         {
 312             // need to remove WS_CLIPSIBLINGS from all sibling windows
 313             // that are within this staticbox if set
 314             if ( style & WS_CLIPSIBLINGS )
 315             {
 316                 style &= ~WS_CLIPSIBLINGS;
 317                 ::SetWindowLong(child, GWL_STYLE, style);
 318
 319                 // MSDN: "If you have changed certain window data using
 320                 // SetWindowLong, you must call SetWindowPos to have the
 321                 // changes take effect."
 322                 ::SetWindowPos(child, NULL, 0, 0, 0, 0,
 323                                SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER |
 324                                SWP_FRAMECHANGED);
 325             }
 326
 327             AutoHRGN hrgnChild(::CreateRectRgnIndirect(&rc));
 328             ::CombineRgn(hrgn, hrgn, hrgnChild, RGN_DIFF);
 329         }
 330     }
 331
 332     return (WXHRGN)hrgn;
 333 }
 334
 335 // helper for OnPaint(): really erase the background, i.e. do it even if we
 336 // don't have any non default brush for doing it (DoEraseBackground() doesn't
 337 // do anything in such case)
 338 void wxStaticBox::PaintBackground(wxDC& dc, const RECT& rc)
 339 {
 340     // note that we do not use the box background colour here, it shouldn't
 341     // apply to its interior for several reasons:
 342     //  1. wxGTK doesn't do it
 343     //  2. controls inside the box don't get correct bg colour because they
 344     //     are not our children so we'd have some really ugly colour mix if
 345     //     we did it
 346     //  3. this is backwards compatible behaviour and some people rely on it,
 347     //     see http://groups.google.com/groups?selm=4252E932.3080801%40able.es
 348     wxWindow *parent = GetParent();
 349     HBRUSH hbr = (HBRUSH)parent->MSWGetBgBrush(dc.GetHDC(), GetHWND());
 350
 351     // if there is no special brush for painting this control, just use the
 352     // solid background colour
 353     wxBrush brush;
 354     if ( !hbr )
 355     {
 356         brush = wxBrush(parent->GetBackgroundColour());
 357         hbr = GetHbrushOf(brush);
 358     }
 359
 360     ::FillRect(GetHdcOf(dc), &rc, hbr);
 361 }
 362
 363 void wxStaticBox::PaintForeground(wxDC& dc, const RECT& WXUNUSED(rc))
 364 {
 365     MSWDefWindowProc(WM_PAINT, (WPARAM)GetHdcOf(dc), 0);
 366
 367     // when using XP themes, neither setting the text colour nor transparent
 368     // background mode doesn't change anything: the static box def window proc
 369     // still draws the label in its own colours, so we need to redraw the text
 370     // ourselves if we have a non default fg colour
 371     if ( m_hasFgCol && wxUxThemeEngine::GetIfActive() )
 372     {
 373         // draw over the text in default colour in our colour
 374         dc.SetFont(GetFont());
 375
 376         HDC hdc = GetHdcOf(dc);
 377         ::SetTextColor(hdc, GetForegroundColour().GetPixel());
 378
 379         // FIXME: value of x is hardcoded as this is what it is on my system,
 380         //        no idea if it's true everywhere
 381         const int y = dc.GetCharHeight();
 382         const int x = 9;
 383
 384         // TODO: RTL?
 385         RECT rc = { x, 0, GetSize().x - x, y };
 386
 387         const wxString label = GetLabel();
 388         ::DrawText(hdc, label, label.length(), &rc, DT_SINGLELINE | DT_VCENTER);
 389     }
 390 }
 391
 392 void wxStaticBox::OnPaint(wxPaintEvent& WXUNUSED(event))
 393 {
 394     RECT rc;
 395     ::GetClientRect(GetHwnd(), &rc);
 396
 397     // draw the entire box in a memory DC
 398     wxMemoryDC memdc;
 399     wxBitmap bitmap(rc.right, rc.bottom);
 400     memdc.SelectObject(bitmap);
 401
 402     PaintBackground(memdc, rc);
 403     PaintForeground(memdc, rc);
 404
 405     // now only blit the static box border itself, not the interior, to avoid
 406     // flicker when background is drawn below
 407     //
 408     // note that it seems to be faster to do 4 small blits here and then paint
 409     // directly into wxPaintDC than painting background in wxMemoryDC and then
 410     // blitting everything at once to wxPaintDC, this is why we do it like this
 411     wxPaintDC dc(this);
 412     int borderTop, border;
 413     GetBordersForSizer(&borderTop, &border);
 414
 415     // top
 416     dc.Blit(border, 0, rc.right - border, borderTop,
 417             &memdc, border, 0);
 418     // bottom
 419     dc.Blit(border, rc.bottom - border, rc.right - border, rc.bottom,
 420             &memdc, border, rc.bottom - border);
 421     // left
 422     dc.Blit(0, 0, border, rc.bottom,
 423             &memdc, 0, 0);
 424     // right
 425     dc.Blit(rc.right - border, 0, rc.right, rc.bottom,
 426             &memdc, rc.right - border, 0);
 427
 428
 429     // create the region excluding box children
 430     AutoHRGN hrgn((HRGN)MSWGetRegionWithoutChildren());
 431     RECT rcWin;
 432     ::GetWindowRect(GetHwnd(), &rcWin);
 433     ::OffsetRgn(hrgn, -rcWin.left, -rcWin.top);
 434
 435     // and also the box itself
 436     MSWGetRegionWithoutSelf((WXHRGN) hrgn, rc.right, rc.bottom);
 437     HDCClipper clipToBg(GetHdcOf(dc), hrgn);
 438
 439     // paint the inside of the box (excluding box itself and child controls)
 440     PaintBackground(dc, rc);
 441 }
 442
 443 #endif // !__WXWINCE__
 444
 445 #endif // wxUSE_STATBOX
 446