src/msw/statbox.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/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 // For compilers that support precompilation, includes "wx.h".
  21 #include "wx/wxprec.h"
  22
  23 #ifdef __BORLANDC__
  24     #pragma hdrstop
  25 #endif
  26
  27 #if wxUSE_STATBOX
  28
  29 #include "wx/statbox.h"
  30
  31 #ifndef WX_PRECOMP
  32     #include "wx/app.h"
  33     #include "wx/dcclient.h"
  34     #include "wx/dcmemory.h"
  35     #include "wx/image.h"
  36 #endif
  37
  38 #include "wx/notebook.h"
  39 #include "wx/sysopt.h"
  40
  41 #include "wx/msw/uxtheme.h"
  42 #include "wx/msw/private.h"
  43 #include "wx/msw/missing.h"
  44 #include "wx/msw/dc.h"
  45
  46 // the values coincide with those in tmschema.h
  47 #define BP_GROUPBOX 4
  48
  49 #define GBS_NORMAL 1
  50
  51 #define TMT_FONT 210
  52
  53 // ----------------------------------------------------------------------------
  54 // wxWin macros
  55 // ----------------------------------------------------------------------------
  56
  57 #if wxUSE_EXTENDED_RTTI
  58 WX_DEFINE_FLAGS( wxStaticBoxStyle )
  59
  60 wxBEGIN_FLAGS( wxStaticBoxStyle )
  61     // new style border flags, we put them first to
  62     // use them for streaming out
  63     wxFLAGS_MEMBER(wxBORDER_SIMPLE)
  64     wxFLAGS_MEMBER(wxBORDER_SUNKEN)
  65     wxFLAGS_MEMBER(wxBORDER_DOUBLE)
  66     wxFLAGS_MEMBER(wxBORDER_RAISED)
  67     wxFLAGS_MEMBER(wxBORDER_STATIC)
  68     wxFLAGS_MEMBER(wxBORDER_NONE)
  69
  70     // old style border flags
  71     wxFLAGS_MEMBER(wxSIMPLE_BORDER)
  72     wxFLAGS_MEMBER(wxSUNKEN_BORDER)
  73     wxFLAGS_MEMBER(wxDOUBLE_BORDER)
  74     wxFLAGS_MEMBER(wxRAISED_BORDER)
  75     wxFLAGS_MEMBER(wxSTATIC_BORDER)
  76     wxFLAGS_MEMBER(wxBORDER)
  77
  78     // standard window styles
  79     wxFLAGS_MEMBER(wxTAB_TRAVERSAL)
  80     wxFLAGS_MEMBER(wxCLIP_CHILDREN)
  81     wxFLAGS_MEMBER(wxTRANSPARENT_WINDOW)
  82     wxFLAGS_MEMBER(wxWANTS_CHARS)
  83     wxFLAGS_MEMBER(wxFULL_REPAINT_ON_RESIZE)
  84     wxFLAGS_MEMBER(wxALWAYS_SHOW_SB )
  85     wxFLAGS_MEMBER(wxVSCROLL)
  86     wxFLAGS_MEMBER(wxHSCROLL)
  87
  88 wxEND_FLAGS( wxStaticBoxStyle )
  89
  90 IMPLEMENT_DYNAMIC_CLASS_XTI(wxStaticBox, wxControl,"wx/statbox.h")
  91
  92 wxBEGIN_PROPERTIES_TABLE(wxStaticBox)
  93     wxPROPERTY( Label,wxString, SetLabel, GetLabel, wxString() , 0 /*flags*/ , wxT("Helpstring") , wxT("group"))
  94     wxPROPERTY_FLAGS( WindowStyle , wxStaticBoxStyle , long , SetWindowStyleFlag , GetWindowStyleFlag , EMPTY_MACROVALUE, 0 /*flags*/ , wxT("Helpstring") , wxT("group")) // style
  95 /*
  96     TODO PROPERTIES :
  97         label
  98 */
  99 wxEND_PROPERTIES_TABLE()
 100
 101 wxBEGIN_HANDLERS_TABLE(wxStaticBox)
 102 wxEND_HANDLERS_TABLE()
 103
 104 wxCONSTRUCTOR_6( wxStaticBox , wxWindow* , Parent , wxWindowID , Id , wxString , Label , wxPoint , Position , wxSize , Size , long , WindowStyle )
 105 #else
 106 IMPLEMENT_DYNAMIC_CLASS(wxStaticBox, wxControl)
 107 #endif
 108
 109 // ============================================================================
 110 // implementation
 111 // ============================================================================
 112
 113 // ----------------------------------------------------------------------------
 114 // wxStaticBox
 115 // ----------------------------------------------------------------------------
 116
 117 bool wxStaticBox::Create(wxWindow *parent,
 118                          wxWindowID id,
 119                          const wxString& label,
 120                          const wxPoint& pos,
 121                          const wxSize& size,
 122                          long style,
 123                          const wxString& name)
 124 {
 125     if ( !CreateControl(parent, id, pos, size, style, wxDefaultValidator, name) )
 126         return false;
 127
 128     if ( !MSWCreateControl(wxT("BUTTON"), label, pos, size) )
 129         return false;
 130
 131     // Always use LTR layout. Otherwise, the label would be mirrored.
 132     SetLayoutDirection(wxLayout_LeftToRight);
 133
 134 #ifndef __WXWINCE__
 135     if (!wxSystemOptions::IsFalse(wxT("msw.staticbox.optimized-paint")))
 136         Connect(wxEVT_PAINT, wxPaintEventHandler(wxStaticBox::OnPaint));
 137 #endif // !__WXWINCE__
 138
 139     return true;
 140 }
 141
 142 WXDWORD wxStaticBox::MSWGetStyle(long style, WXDWORD *exstyle) const
 143 {
 144     long styleWin = wxStaticBoxBase::MSWGetStyle(style, exstyle);
 145
 146     // no need for it anymore, must be removed for wxRadioBox child
 147     // buttons to be able to repaint themselves
 148     styleWin &= ~WS_CLIPCHILDREN;
 149
 150     if ( exstyle )
 151     {
 152 #ifndef __WXWINCE__
 153         if (wxSystemOptions::IsFalse(wxT("msw.staticbox.optimized-paint")))
 154             *exstyle = WS_EX_TRANSPARENT;
 155         else
 156 #endif
 157             *exstyle = 0;
 158     }
 159
 160     styleWin |= BS_GROUPBOX;
 161
 162     if ( wxTheApp->GetLayoutDirection() == wxLayout_RightToLeft )
 163     {
 164         // Make sure label is on the right
 165         styleWin |= BS_RIGHT;
 166     }
 167
 168     return styleWin;
 169 }
 170
 171 wxSize wxStaticBox::DoGetBestSize() const
 172 {
 173     int cx, cy;
 174     wxGetCharSize(GetHWND(), &cx, &cy, GetFont());
 175
 176     int wBox;
 177     GetTextExtent(GetLabelText(wxGetWindowText(m_hWnd)), &wBox, &cy);
 178
 179     wBox += 3*cx;
 180     int hBox = EDIT_HEIGHT_FROM_CHAR_HEIGHT(cy);
 181
 182     wxSize best(wBox, hBox);
 183     CacheBestSize(best);
 184     return best;
 185 }
 186
 187 void wxStaticBox::GetBordersForSizer(int *borderTop, int *borderOther) const
 188 {
 189     wxStaticBoxBase::GetBordersForSizer(borderTop, borderOther);
 190
 191     // need extra space, don't know how much but this seems to be enough
 192     *borderTop += GetCharHeight()/3;
 193 }
 194
 195 // all the hacks below are not necessary for WinCE
 196 #ifndef __WXWINCE__
 197
 198 WXLRESULT wxStaticBox::MSWWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam)
 199 {
 200     if ( nMsg == WM_NCHITTEST )
 201     {
 202         // This code breaks some other processing such as enter/leave tracking
 203         // so it's off by default.
 204
 205         static int s_useHTClient = -1;
 206         if (s_useHTClient == -1)
 207             s_useHTClient = wxSystemOptions::GetOptionInt(wxT("msw.staticbox.htclient"));
 208         if (s_useHTClient == 1)
 209         {
 210             int xPos = GET_X_LPARAM(lParam);
 211             int yPos = GET_Y_LPARAM(lParam);
 212
 213             ScreenToClient(&xPos, &yPos);
 214
 215             // Make sure you can drag by the top of the groupbox, but let
 216             // other (enclosed) controls get mouse events also
 217             if ( yPos < 10 )
 218                 return (long)HTCLIENT;
 219         }
 220     }
 221
 222     if ( nMsg == WM_PRINTCLIENT )
 223     {
 224         // we have to process WM_PRINTCLIENT ourselves as otherwise child
 225         // windows' background (eg buttons in radio box) would never be drawn
 226         // unless we have a parent with non default background
 227
 228         // so check first if we have one
 229         if ( !HandlePrintClient((WXHDC)wParam) )
 230         {
 231             // no, we don't, erase the background ourselves
 232             // (don't use our own) - see PaintBackground for explanation
 233             wxBrush brush(GetParent()->GetBackgroundColour());
 234             wxFillRect(GetHwnd(), (HDC)wParam, GetHbrushOf(brush));
 235         }
 236
 237         return 0;
 238     }
 239
 240     if ( nMsg == WM_UPDATEUISTATE )
 241     {
 242         // DefWindowProc() redraws just the static box text when it gets this
 243         // message and it does it using the standard (blue in standard theme)
 244         // colour and not our own label colour that we use in PaintForeground()
 245         // resulting in the label mysteriously changing the colour when e.g.
 246         // "Alt" is pressed anywhere in the window, see #12497.
 247         //
 248         // To avoid this we simply refresh the window forcing our own code
 249         // redrawing the label in the correct colour to be called. This is
 250         // inefficient but there doesn't seem to be anything else we can do.
 251         //
 252         // Notice that the problem is XP-specific and doesn't arise under later
 253         // systems.
 254         if ( m_hasFgCol && wxGetWinVersion() == wxWinVersion_XP )
 255             Refresh();
 256     }
 257
 258     return wxControl::MSWWindowProc(nMsg, wParam, lParam);
 259 }
 260
 261 // ----------------------------------------------------------------------------
 262 // static box drawing
 263 // ----------------------------------------------------------------------------
 264
 265 /*
 266    We draw the static box ourselves because it's the only way to prevent it
 267    from flickering horribly on resize (because everything inside the box is
 268    erased twice: once when the box itself is repainted and second time when
 269    the control inside it is repainted) without using WS_EX_TRANSPARENT style as
 270    we used to do and which resulted in other problems.
 271  */
 272
 273 // MSWGetRegionWithoutSelf helper: removes the given rectangle from region
 274 static inline void
 275 SubtractRectFromRgn(HRGN hrgn, int left, int top, int right, int bottom)
 276 {
 277     AutoHRGN hrgnRect(::CreateRectRgn(left, top, right, bottom));
 278     if ( !hrgnRect )
 279     {
 280         wxLogLastError(wxT("CreateRectRgn()"));
 281         return;
 282     }
 283
 284     ::CombineRgn(hrgn, hrgn, hrgnRect, RGN_DIFF);
 285 }
 286
 287 void wxStaticBox::MSWGetRegionWithoutSelf(WXHRGN hRgn, int w, int h)
 288 {
 289     HRGN hrgn = (HRGN)hRgn;
 290
 291     // remove the area occupied by the static box borders from the region
 292     int borderTop, border;
 293     GetBordersForSizer(&borderTop, &border);
 294
 295     // top
 296     SubtractRectFromRgn(hrgn, 0, 0, w, borderTop);
 297
 298     // bottom
 299     SubtractRectFromRgn(hrgn, 0, h - border, w, h);
 300
 301     // left
 302     SubtractRectFromRgn(hrgn, 0, 0, border, h);
 303
 304     // right
 305     SubtractRectFromRgn(hrgn, w - border, 0, w, h);
 306 }
 307
 308 WXHRGN wxStaticBox::MSWGetRegionWithoutChildren()
 309 {
 310     RECT rc;
 311     ::GetWindowRect(GetHwnd(), &rc);
 312     HRGN hrgn = ::CreateRectRgn(rc.left, rc.top, rc.right + 1, rc.bottom + 1);
 313     bool foundThis = false;
 314
 315     // iterate over all child windows (not just wxWindows but all windows)
 316     for ( HWND child = ::GetWindow(GetHwndOf(GetParent()), GW_CHILD);
 317           child;
 318           child = ::GetWindow(child, GW_HWNDNEXT) )
 319     {
 320         if ( ! ::IsWindowVisible(child) )
 321         {
 322             // if the window isn't visible then it doesn't need clipped
 323             continue;
 324         }
 325
 326         LONG style = ::GetWindowLong(child, GWL_STYLE);
 327         wxString str(wxGetWindowClass(child));
 328         str.UpperCase();
 329         if ( str == wxT("BUTTON") && (style & BS_GROUPBOX) == BS_GROUPBOX )
 330         {
 331             if ( child == GetHwnd() )
 332                 foundThis = true;
 333
 334             // Any static boxes below this one in the Z-order can't be clipped
 335             // since if we have the case where a static box with a low Z-order
 336             // is nested inside another static box with a high Z-order then the
 337             // nested static box would be painted over. Doing it this way
 338             // unfortunately results in flicker if the Z-order of nested static
 339             // boxes is not inside (lowest) to outside (highest) but at least
 340             // they are still shown.
 341             if ( foundThis )
 342                 continue;
 343         }
 344
 345         ::GetWindowRect(child, &rc);
 346         if ( ::RectInRegion(hrgn, &rc) )
 347         {
 348             // need to remove WS_CLIPSIBLINGS from all sibling windows
 349             // that are within this staticbox if set
 350             if ( style & WS_CLIPSIBLINGS )
 351             {
 352                 style &= ~WS_CLIPSIBLINGS;
 353                 ::SetWindowLong(child, GWL_STYLE, style);
 354
 355                 // MSDN: "If you have changed certain window data using
 356                 // SetWindowLong, you must call SetWindowPos to have the
 357                 // changes take effect."
 358                 ::SetWindowPos(child, NULL, 0, 0, 0, 0,
 359                                SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER |
 360                                SWP_FRAMECHANGED);
 361             }
 362
 363             AutoHRGN hrgnChild(::CreateRectRgnIndirect(&rc));
 364             ::CombineRgn(hrgn, hrgn, hrgnChild, RGN_DIFF);
 365         }
 366     }
 367
 368     return (WXHRGN)hrgn;
 369 }
 370
 371 // helper for OnPaint(): really erase the background, i.e. do it even if we
 372 // don't have any non default brush for doing it (DoEraseBackground() doesn't
 373 // do anything in such case)
 374 void wxStaticBox::PaintBackground(wxDC& dc, const RECT& rc)
 375 {
 376     // note that we do not use the box background colour here, it shouldn't
 377     // apply to its interior for several reasons:
 378     //  1. wxGTK doesn't do it
 379     //  2. controls inside the box don't get correct bg colour because they
 380     //     are not our children so we'd have some really ugly colour mix if
 381     //     we did it
 382     //  3. this is backwards compatible behaviour and some people rely on it,
 383     //     see http://groups.google.com/groups?selm=4252E932.3080801%40able.es
 384     wxMSWDCImpl *impl = (wxMSWDCImpl*) dc.GetImpl();
 385     HBRUSH hbr = MSWGetBgBrush(impl->GetHDC());
 386
 387     // if there is no special brush for painting this control, just use the
 388     // solid background colour
 389     wxBrush brush;
 390     if ( !hbr )
 391     {
 392         brush = wxBrush(GetParent()->GetBackgroundColour());
 393         hbr = GetHbrushOf(brush);
 394     }
 395
 396     ::FillRect(GetHdcOf(*impl), &rc, hbr);
 397 }
 398
 399 void wxStaticBox::PaintForeground(wxDC& dc, const RECT& rc)
 400 {
 401     wxMSWDCImpl *impl = (wxMSWDCImpl*) dc.GetImpl();
 402     MSWDefWindowProc(WM_PAINT, (WPARAM)GetHdcOf(*impl), 0);
 403
 404     // when using XP themes, neither setting the text colour nor transparent
 405     // background mode doesn't change anything: the static box def window proc
 406     // still draws the label in its own colours, so we need to redraw the text
 407     // ourselves if we have a non default fg colour
 408     if ( m_hasFgCol && wxUxThemeEngine::GetIfActive() )
 409     {
 410         // draw over the text in default colour in our colour
 411         HDC hdc = GetHdcOf(*impl);
 412         ::SetTextColor(hdc, GetForegroundColour().GetPixel());
 413
 414         const bool rtl = wxTheApp->GetLayoutDirection() == wxLayout_RightToLeft;
 415         if ( rtl )
 416             ::SetTextAlign(hdc, TA_RTLREADING | TA_RIGHT);
 417
 418         // Get dimensions of the label
 419         const wxString label = GetLabel();
 420
 421         // choose the correct font
 422         AutoHFONT font;
 423         SelectInHDC selFont;
 424         if ( m_hasFont )
 425         {
 426             selFont.Init(hdc, GetHfontOf(GetFont()));
 427         }
 428         else // no font set, use the one set by the theme
 429         {
 430             wxUxThemeHandle hTheme(this, L"BUTTON");
 431             if ( hTheme )
 432             {
 433                 // GetThemeFont() expects its parameter to be LOGFONTW and not
 434                 // LOGFONTA even in ANSI programs and will happily corrupt
 435                 // memory after the struct end if we pass a LOGFONTA (which is
 436                 // smaller) to it!
 437                 LOGFONTW lfw;
 438                 if ( wxUxThemeEngine::Get()->GetThemeFont
 439                                              (
 440                                                 hTheme,
 441                                                 hdc,
 442                                                 BP_GROUPBOX,
 443                                                 GBS_NORMAL,
 444                                                 TMT_FONT,
 445                                                 (LOGFONT *)&lfw
 446                                              ) == S_OK )
 447                 {
 448 #if wxUSE_UNICODE
 449                     // ok, no conversion necessary
 450                     const LOGFONT& lf = lfw;
 451 #else // !wxUSE_UNICODE
 452                     // most of the fields are the same in LOGFONTA and LOGFONTW
 453                     LOGFONT lf;
 454                     memcpy(&lf, &lfw, sizeof(lf));
 455
 456                     // but the face name must be converted
 457                     WideCharToMultiByte(CP_ACP, 0, lfw.lfFaceName, -1,
 458                                         lf.lfFaceName, sizeof(lf.lfFaceName),
 459                                         NULL, NULL);
 460 #endif // wxUSE_UNICODE/!wxUSE_UNICODE
 461
 462                     font.Init(lf);
 463                     if ( font )
 464                         selFont.Init(hdc, font);
 465                 }
 466             }
 467         }
 468
 469         // Get the font extent
 470         int width, height;
 471         dc.GetTextExtent(wxStripMenuCodes(label, wxStrip_Mnemonics),
 472                          &width, &height);
 473
 474         int x;
 475         int y = height;
 476
 477         // first we need to correctly paint the background of the label
 478         // as Windows ignores the brush offset when doing it
 479         //
 480         // FIXME: value of x is hardcoded as this is what it is on my system,
 481         //        no idea if it's true everywhere
 482         RECT dimensions = {0, 0, 0, y};
 483         if ( !rtl )
 484         {
 485             x = 9;
 486             dimensions.left = x;
 487             dimensions.right = x + width;
 488         }
 489         else
 490         {
 491             x = rc.right - 7;
 492             dimensions.left = x - width;
 493             dimensions.right = x;
 494         }
 495
 496         // need to adjust the rectangle to cover all the label background
 497         dimensions.left -= 2;
 498         dimensions.right += 2;
 499         dimensions.bottom += 2;
 500
 501         if ( UseBgCol() )
 502         {
 503             // our own background colour should be used for the background of
 504             // the label: this is consistent with the behaviour under pre-XP
 505             // systems (i.e. without visual themes) and generally makes sense
 506             wxBrush brush = wxBrush(GetBackgroundColour());
 507             wxMSWDCImpl *impl = (wxMSWDCImpl*) dc.GetImpl();
 508             ::FillRect(GetHdcOf(*impl), &dimensions, GetHbrushOf(brush));
 509         }
 510         else // paint parent background
 511         {
 512             PaintBackground(dc, dimensions);
 513         }
 514
 515         UINT drawTextFlags = DT_SINGLELINE | DT_VCENTER;
 516
 517         // determine the state of UI queues to draw the text correctly under XP
 518         // and later systems
 519         static const bool isXPorLater = wxGetWinVersion() >= wxWinVersion_XP;
 520         if ( isXPorLater )
 521         {
 522             if ( ::SendMessage(GetHwnd(), WM_QUERYUISTATE, 0, 0) &
 523                     UISF_HIDEACCEL )
 524             {
 525                 drawTextFlags |= DT_HIDEPREFIX;
 526             }
 527         }
 528
 529         // now draw the text
 530         if ( !rtl )
 531         {
 532             RECT rc2 = { x, 0, x + width, y };
 533             ::DrawText(hdc, label.wx_str(), label.length(), &rc2,
 534                        drawTextFlags);
 535         }
 536         else // RTL
 537         {
 538             RECT rc2 = { x, 0, x - width, y };
 539             ::DrawText(hdc, label.wx_str(), label.length(), &rc2,
 540                        drawTextFlags | DT_RTLREADING);
 541         }
 542     }
 543 }
 544
 545 void wxStaticBox::OnPaint(wxPaintEvent& WXUNUSED(event))
 546 {
 547     RECT rc;
 548     ::GetClientRect(GetHwnd(), &rc);
 549
 550     // draw the entire box in a memory DC
 551     wxMemoryDC memdc;
 552     wxBitmap bitmap(rc.right, rc.bottom);
 553     memdc.SelectObject(bitmap);
 554
 555     PaintBackground(memdc, rc);
 556     PaintForeground(memdc, rc);
 557
 558     // now only blit the static box border itself, not the interior, to avoid
 559     // flicker when background is drawn below
 560     //
 561     // note that it seems to be faster to do 4 small blits here and then paint
 562     // directly into wxPaintDC than painting background in wxMemoryDC and then
 563     // blitting everything at once to wxPaintDC, this is why we do it like this
 564     wxPaintDC dc(this);
 565     int borderTop, border;
 566     GetBordersForSizer(&borderTop, &border);
 567
 568     // top
 569     dc.Blit(border, 0, rc.right - border, borderTop,
 570             &memdc, border, 0);
 571     // bottom
 572     dc.Blit(border, rc.bottom - border, rc.right - border, border,
 573             &memdc, border, rc.bottom - border);
 574     // left
 575     dc.Blit(0, 0, border, rc.bottom,
 576             &memdc, 0, 0);
 577     // right (note that upper and bottom right corners were already part of the
 578     // first two blits so we shouldn't overwrite them here to avoi flicker)
 579     dc.Blit(rc.right - border, borderTop,
 580             border, rc.bottom - borderTop - border,
 581             &memdc, rc.right - border, borderTop);
 582
 583
 584     // create the region excluding box children
 585     AutoHRGN hrgn((HRGN)MSWGetRegionWithoutChildren());
 586     RECT rcWin;
 587     ::GetWindowRect(GetHwnd(), &rcWin);
 588     ::OffsetRgn(hrgn, -rcWin.left, -rcWin.top);
 589
 590     // and also the box itself
 591     MSWGetRegionWithoutSelf((WXHRGN) hrgn, rc.right, rc.bottom);
 592     wxMSWDCImpl *impl = (wxMSWDCImpl*) dc.GetImpl();
 593     HDCClipper clipToBg(GetHdcOf(*impl), hrgn);
 594
 595     // paint the inside of the box (excluding box itself and child controls)
 596     PaintBackground(dc, rc);
 597 }
 598
 599 #endif // !__WXWINCE__
 600
 601 #endif // wxUSE_STATBOX