src/generic/renderg.cpp

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/generic/renderg.cpp
   3 // Purpose:     generic implementation of wxRendererNative (for any platform)
   4 // Author:      Vadim Zeitlin
   5 // Modified by:
   6 // Created:     20.07.2003
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 2003 Vadim Zeitlin <vadim@wxwindows.org>
   9 // License:     wxWindows license
  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 #include "wx/renderer.h"
  28
  29 #ifndef WX_PRECOMP
  30     #include "wx/string.h"
  31     #include "wx/dc.h"
  32 #endif //WX_PRECOMP
  33
  34 #include "wx/gdicmn.h"
  35
  36 #include "wx/settings.h"
  37 #include "wx/splitter.h"
  38 #include "wx/dcmirror.h"
  39 #include "wx/module.h"
  40
  41 // ----------------------------------------------------------------------------
  42 // wxRendererGeneric: our wxRendererNative implementation
  43 // ----------------------------------------------------------------------------
  44
  45 class WXDLLEXPORT wxRendererGeneric : public wxRendererNative
  46 {
  47 public:
  48     wxRendererGeneric();
  49
  50     virtual void DrawHeaderButton(wxWindow *win,
  51                                   wxDC& dc,
  52                                   const wxRect& rect,
  53                                   int flags = 0);
  54
  55     virtual void DrawTreeItemButton(wxWindow *win,
  56                                     wxDC& dc,
  57                                     const wxRect& rect,
  58                                     int flags = 0);
  59
  60     virtual void DrawSplitterBorder(wxWindow *win,
  61                                     wxDC& dc,
  62                                     const wxRect& rect,
  63                                     int flags = 0);
  64
  65     virtual void DrawSplitterSash(wxWindow *win,
  66                                   wxDC& dc,
  67                                   const wxSize& size,
  68                                   wxCoord position,
  69                                   wxOrientation orient,
  70                                   int flags = 0);
  71
  72     virtual void DrawComboBoxDropButton(wxWindow *win,
  73                                         wxDC& dc,
  74                                         const wxRect& rect,
  75                                         int flags = 0);
  76
  77     virtual void DrawDropArrow(wxWindow *win,
  78                                wxDC& dc,
  79                                const wxRect& rect,
  80                                int flags = 0);
  81
  82     virtual void DrawCheckBox(wxWindow *win,
  83                               wxDC& dc,
  84                               const wxRect& rect,
  85                               int flags = 0);
  86
  87     virtual void DrawPushButton(wxWindow *win,
  88                                 wxDC& dc,
  89                                 const wxRect& rect,
  90                                 int flags = 0);
  91
  92     virtual void DrawItemSelectionRect(wxWindow *win,
  93                                        wxDC& dc,
  94                                        const wxRect& rect,
  95                                        int flags = 0);
  96
  97     virtual wxSplitterRenderParams GetSplitterParams(const wxWindow *win);
  98
  99     virtual wxRendererVersion GetVersion() const
 100     {
 101         return wxRendererVersion(wxRendererVersion::Current_Version,
 102                                  wxRendererVersion::Current_Age);
 103     }
 104
 105
 106     // Cleanup by deleting standard renderer
 107     static void Cleanup();
 108
 109     // Get the generic object
 110     static wxRendererGeneric* DoGetGeneric();
 111
 112 protected:
 113     // draw the rectange using the first pen for the left and top sides and
 114     // the second one for the bottom and right ones
 115     void DrawShadedRect(wxDC& dc, wxRect *rect,
 116                         const wxPen& pen1, const wxPen& pen2);
 117
 118     // the standard pens
 119     wxPen m_penBlack,
 120           m_penDarkGrey,
 121           m_penLightGrey,
 122           m_penHighlight;
 123
 124     static wxRendererGeneric* sm_rendererGeneric;
 125 };
 126
 127 // ============================================================================
 128 // wxRendererGeneric implementation
 129 // ============================================================================
 130
 131 // Get the generic object
 132 wxRendererGeneric* wxRendererGeneric::DoGetGeneric()
 133 {
 134     if (!sm_rendererGeneric)
 135         sm_rendererGeneric = new wxRendererGeneric;
 136     return sm_rendererGeneric;
 137 }
 138
 139 // ----------------------------------------------------------------------------
 140 // wxRendererGeneric creation
 141 // ----------------------------------------------------------------------------
 142
 143 /* static */
 144 wxRendererNative& wxRendererNative::GetGeneric()
 145 {
 146     return * wxRendererGeneric::DoGetGeneric();
 147 }
 148
 149 void wxRendererGeneric::Cleanup()
 150 {
 151     if (sm_rendererGeneric)
 152         delete sm_rendererGeneric;
 153
 154     sm_rendererGeneric = NULL;
 155 }
 156
 157 wxRendererGeneric* wxRendererGeneric::sm_rendererGeneric = NULL;
 158
 159 wxRendererGeneric::wxRendererGeneric()
 160     : m_penBlack(wxSystemSettings::GetColour(wxSYS_COLOUR_3DDKSHADOW)),
 161       m_penDarkGrey(wxSystemSettings::GetColour(wxSYS_COLOUR_3DSHADOW)),
 162       m_penLightGrey(wxSystemSettings::GetColour(wxSYS_COLOUR_3DFACE)),
 163       m_penHighlight(wxSystemSettings::GetColour(wxSYS_COLOUR_3DHIGHLIGHT))
 164 {
 165 }
 166
 167 // ----------------------------------------------------------------------------
 168 // wxRendererGeneric helpers
 169 // ----------------------------------------------------------------------------
 170
 171 void
 172 wxRendererGeneric::DrawShadedRect(wxDC& dc,
 173                                   wxRect *rect,
 174                                   const wxPen& pen1,
 175                                   const wxPen& pen2)
 176 {
 177     // draw the rectangle
 178     dc.SetPen(pen1);
 179     dc.DrawLine(rect->GetLeft(), rect->GetTop(),
 180                 rect->GetLeft(), rect->GetBottom());
 181     dc.DrawLine(rect->GetLeft() + 1, rect->GetTop(),
 182                 rect->GetRight(), rect->GetTop());
 183     dc.SetPen(pen2);
 184     dc.DrawLine(rect->GetRight(), rect->GetTop(),
 185                 rect->GetRight(), rect->GetBottom());
 186     dc.DrawLine(rect->GetLeft(), rect->GetBottom(),
 187                 rect->GetRight() + 1, rect->GetBottom());
 188
 189     // adjust the rect
 190     rect->Inflate(-1);
 191 }
 192
 193 // ----------------------------------------------------------------------------
 194 // tree/list ctrl drawing
 195 // ----------------------------------------------------------------------------
 196
 197 void
 198 wxRendererGeneric::DrawHeaderButton(wxWindow * WXUNUSED(win),
 199                                     wxDC& dc,
 200                                     const wxRect& rect,
 201                                     int WXUNUSED(flags))
 202 {
 203     const int CORNER = 1;
 204
 205     const wxCoord x = rect.x,
 206                   y = rect.y,
 207                   w = rect.width,
 208                   h = rect.height;
 209
 210     dc.SetBrush(*wxTRANSPARENT_BRUSH);
 211
 212     dc.SetPen(m_penBlack);
 213     dc.DrawLine( x+w-CORNER+1, y, x+w, y+h );  // right (outer)
 214     dc.DrawRectangle( x, y+h, w+1, 1 );        // bottom (outer)
 215
 216     dc.SetPen(m_penDarkGrey);
 217     dc.DrawLine( x+w-CORNER, y, x+w-1, y+h );  // right (inner)
 218     dc.DrawRectangle( x+1, y+h-1, w-2, 1 );    // bottom (inner)
 219
 220     dc.SetPen(m_penHighlight);
 221     dc.DrawRectangle( x, y, w-CORNER+1, 1 );   // top (outer)
 222     dc.DrawRectangle( x, y, 1, h );            // left (outer)
 223     dc.DrawLine( x, y+h-1, x+1, y+h-1 );
 224     dc.DrawLine( x+w-1, y, x+w-1, y+1 );
 225 }
 226
 227 // draw the plus or minus sign
 228 void
 229 wxRendererGeneric::DrawTreeItemButton(wxWindow * WXUNUSED(win),
 230                                       wxDC& dc,
 231                                       const wxRect& rect,
 232                                       int flags)
 233 {
 234     // store settings
 235     wxPen pen(dc.GetPen());
 236     wxBrush brush(dc.GetBrush());
 237
 238     // white background
 239     dc.SetPen(*wxGREY_PEN);
 240     dc.SetBrush(*wxWHITE_BRUSH);
 241     dc.DrawRectangle(rect);
 242
 243     // black lines
 244     const wxCoord xMiddle = rect.x + rect.width/2;
 245     const wxCoord yMiddle = rect.y + rect.height/2;
 246
 247     // half of the length of the horz lines in "-" and "+"
 248     const wxCoord halfWidth = rect.width/2 - 2;
 249     dc.SetPen(*wxBLACK_PEN);
 250     dc.DrawLine(xMiddle - halfWidth, yMiddle,
 251                 xMiddle + halfWidth + 1, yMiddle);
 252
 253     if ( !(flags & wxCONTROL_EXPANDED) )
 254     {
 255         // turn "-" into "+"
 256         const wxCoord halfHeight = rect.height/2 - 2;
 257         dc.DrawLine(xMiddle, yMiddle - halfHeight,
 258                     xMiddle, yMiddle + halfHeight + 1);
 259     }
 260
 261     dc.SetPen(pen);
 262     dc.SetBrush(brush);
 263 }
 264
 265 // ----------------------------------------------------------------------------
 266 // sash drawing
 267 // ----------------------------------------------------------------------------
 268
 269 wxSplitterRenderParams
 270 wxRendererGeneric::GetSplitterParams(const wxWindow *win)
 271 {
 272     // see below
 273     wxCoord sashWidth,
 274             border;
 275
 276     if ( win->HasFlag(wxSP_3DSASH) )
 277         sashWidth = 7;
 278     else if ( win->HasFlag(wxSP_NOSASH) )
 279         sashWidth = 0;
 280     else // no 3D effect
 281         sashWidth = 3;
 282
 283     if ( win->HasFlag(wxSP_3DBORDER) )
 284         border = 2;
 285     else // no 3D effect
 286         border = 0;
 287
 288     return wxSplitterRenderParams(sashWidth, border, false);
 289 }
 290
 291 void
 292 wxRendererGeneric::DrawSplitterBorder(wxWindow *win,
 293                                       wxDC& dc,
 294                                       const wxRect& rectOrig,
 295                                       int WXUNUSED(falgs))
 296 {
 297     if ( win->HasFlag(wxSP_3DBORDER) )
 298     {
 299         wxRect rect = rectOrig;
 300         DrawShadedRect(dc, &rect, m_penDarkGrey, m_penHighlight);
 301         DrawShadedRect(dc, &rect, m_penBlack, m_penLightGrey);
 302     }
 303 }
 304
 305 void
 306 wxRendererGeneric::DrawSplitterSash(wxWindow *win,
 307                                     wxDC& dcReal,
 308                                     const wxSize& sizeReal,
 309                                     wxCoord position,
 310                                     wxOrientation orient,
 311                                     int WXUNUSED(flags))
 312 {
 313     // to avoid duplicating the same code for horizontal and vertical sashes,
 314     // simply mirror the DC instead if needed (i.e. if horz splitter)
 315     wxMirrorDC dc(dcReal, orient != wxVERTICAL);
 316     wxSize size = dc.Reflect(sizeReal);
 317
 318
 319     // we draw a Win32-like grey sash with possible 3D border here:
 320     //
 321     //   ---- this is position
 322     //  /
 323     // v
 324     // dWGGGDd
 325     // GWGGGDB
 326     // GWGGGDB  where G is light grey (face)
 327     // GWGGGDB        W    white      (light)
 328     // GWGGGDB        D    dark grey  (shadow)
 329     // GWGGGDB        B    black      (dark shadow)
 330     // GWGGGDB
 331     // GWGGGDB  and lower letters are our border (already drawn)
 332     // GWGGGDB
 333     // wWGGGDd
 334     //
 335     // only the middle 3 columns are drawn unless wxSP_3D is specified
 336
 337     const wxCoord h = size.y;
 338     wxCoord offset = 0;
 339
 340     // If we're drawing the border, draw the sash 3d lines shorter
 341     if ( win->HasFlag(wxSP_3DBORDER) )
 342     {
 343         offset = 1;
 344     }
 345
 346     dc.SetPen(*wxTRANSPARENT_PEN);
 347     dc.SetBrush(wxBrush(wxSystemSettings::GetColour(wxSYS_COLOUR_3DFACE)));
 348
 349     if ( win->HasFlag(wxSP_3DSASH) )
 350     {
 351         // Draw the 3D sash
 352         dc.DrawRectangle(position + 2, 0, 3, h);
 353
 354         dc.SetPen(m_penLightGrey);
 355         dc.DrawLine(position, offset, position, h - offset);
 356
 357         dc.SetPen(m_penHighlight);
 358         dc.DrawLine(position + 1, 0, position + 1, h);
 359
 360         dc.SetPen(m_penDarkGrey);
 361         dc.DrawLine(position + 5, 0, position + 5, h);
 362
 363         dc.SetPen(m_penBlack);
 364         dc.DrawLine(position + 6, offset, position + 6, h - offset);
 365     }
 366     else
 367     {
 368         // Draw a flat sash
 369         dc.DrawRectangle(position, 0, 3, h);
 370     }
 371 }
 372
 373 // ----------------------------------------------------------------------------
 374 // button drawing
 375 // ----------------------------------------------------------------------------
 376
 377 void
 378 wxRendererGeneric::DrawComboBoxDropButton(wxWindow *win,
 379                                           wxDC& dc,
 380                                           const wxRect& rect,
 381                                           int flags)
 382 {
 383     DrawPushButton(win,dc,rect,flags);
 384     DrawDropArrow(win,dc,rect,flags);
 385 }
 386
 387 void
 388 wxRendererGeneric::DrawDropArrow(wxWindow *win,
 389                                  wxDC& dc,
 390                                  const wxRect& rect,
 391                                  int WXUNUSED(flags))
 392 {
 393     // This generic implementation should be good
 394     // enough for Windows platforms (including XP).
 395
 396     int arrowHalf = rect.width/5;
 397     int rectMid = rect.width / 2;
 398     int arrowTopY = (rect.height/2) - (arrowHalf/2);
 399
 400     // This should always result in arrow with odd width.
 401     wxPoint pt[] =
 402     {
 403         wxPoint(rectMid - arrowHalf, arrowTopY),
 404         wxPoint(rectMid + arrowHalf, arrowTopY),
 405         wxPoint(rectMid, arrowTopY + arrowHalf)
 406     };
 407     dc.SetBrush(wxBrush(win->GetForegroundColour()));
 408     dc.SetPen(wxPen(win->GetForegroundColour()));
 409     dc.DrawPolygon(WXSIZEOF(pt), pt, rect.x, rect.y);
 410 }
 411
 412 void
 413 wxRendererGeneric::DrawCheckBox(wxWindow *WXUNUSED(win),
 414                                 wxDC& dc,
 415                                 const wxRect& rect,
 416                                 int flags)
 417 {
 418     dc.SetPen(*(flags & wxCONTROL_DISABLED ? wxGREY_PEN : wxBLACK_PEN));
 419     dc.SetBrush( *wxTRANSPARENT_BRUSH );
 420     dc.DrawRectangle(rect);
 421
 422     if ( flags & wxCONTROL_CHECKED )
 423     {
 424         dc.DrawCheckMark(rect.Deflate(2, 2));
 425     }
 426 }
 427
 428 void
 429 wxRendererGeneric::DrawPushButton(wxWindow *win,
 430                                   wxDC& dc,
 431                                   const wxRect& rect,
 432                                   int flags)
 433 {
 434     // Don't try anything too fancy. It'll just turn out looking
 435     // out-of-place on most platforms.
 436     wxColour bgCol = flags & wxCONTROL_DISABLED ?
 437                         wxSystemSettings::GetColour(wxSYS_COLOUR_BTNFACE) :
 438                         win->GetBackgroundColour();
 439     dc.SetBrush(wxBrush(bgCol));
 440     dc.SetPen(wxPen(bgCol));
 441     dc.DrawRectangle(rect);
 442 }
 443
 444 void
 445 wxRendererGeneric::DrawItemSelectionRect(wxWindow * WXUNUSED(win),
 446                                          wxDC& dc,
 447                                          const wxRect& rect,
 448                                          int flags)
 449 {
 450     wxBrush brush;
 451     if ( flags & wxCONTROL_SELECTED )
 452     {
 453         if ( flags & wxCONTROL_FOCUSED )
 454         {
 455             brush = wxBrush(wxSystemSettings::GetColour(wxSYS_COLOUR_HIGHLIGHT));
 456         }
 457         else // !focused
 458         {
 459             brush = wxBrush(wxSystemSettings::GetColour(wxSYS_COLOUR_BTNSHADOW));
 460         }
 461     }
 462     else // !selected
 463     {
 464         brush = *wxTRANSPARENT_BRUSH;
 465     }
 466
 467     dc.SetBrush(brush);
 468     dc.SetPen(flags & wxCONTROL_CURRENT ? *wxBLACK_PEN : *wxTRANSPARENT_PEN);
 469
 470     dc.DrawRectangle( rect );
 471 }
 472
 473
 474 // ----------------------------------------------------------------------------
 475 // A module to allow cleanup of generic renderer.
 476 // ----------------------------------------------------------------------------
 477
 478 class wxGenericRendererModule: public wxModule
 479 {
 480 DECLARE_DYNAMIC_CLASS(wxGenericRendererModule)
 481 public:
 482     wxGenericRendererModule() {}
 483     bool OnInit() { return true; };
 484     void OnExit() { wxRendererGeneric::Cleanup(); };
 485 };
 486
 487 IMPLEMENT_DYNAMIC_CLASS(wxGenericRendererModule, wxModule)