1 ///////////////////////////////////////////////////////////////////////////////
2 // Name: src/generic/renderg.cpp
3 // Purpose: generic implementation of wxRendererNative (for any platform)
4 // Author: Vadim Zeitlin
8 // Copyright: (c) 2003 Vadim Zeitlin <vadim@wxwindows.org>
9 // License: wxWindows license
10 ///////////////////////////////////////////////////////////////////////////////
12 // ============================================================================
14 // ============================================================================
16 // ----------------------------------------------------------------------------
18 // ----------------------------------------------------------------------------
20 // for compilers that support precompilation, includes "wx.h".
21 #include "wx/wxprec.h"
27 #include "wx/renderer.h"
30 #include "wx/string.h"
32 #include "wx/settings.h"
33 #include "wx/gdicmn.h"
34 #include "wx/module.h"
37 #include "wx/splitter.h"
38 #include "wx/dcmirror.h"
41 #include "wx/osx/private.h"
44 // ----------------------------------------------------------------------------
45 // wxRendererGeneric: our wxRendererNative implementation
46 // ----------------------------------------------------------------------------
48 class WXDLLEXPORT wxRendererGeneric
: public wxRendererNative
53 virtual int DrawHeaderButton(wxWindow
*win
,
57 wxHeaderSortIconType sortArrow
= wxHDR_SORT_ICON_NONE
,
58 wxHeaderButtonParams
* params
= NULL
);
60 virtual int DrawHeaderButtonContents(wxWindow
*win
,
64 wxHeaderSortIconType sortArrow
= wxHDR_SORT_ICON_NONE
,
65 wxHeaderButtonParams
* params
= NULL
);
67 virtual int GetHeaderButtonHeight(wxWindow
*win
);
69 virtual void DrawTreeItemButton(wxWindow
*win
,
74 virtual void DrawSplitterBorder(wxWindow
*win
,
79 virtual void DrawSplitterSash(wxWindow
*win
,
86 virtual void DrawComboBoxDropButton(wxWindow
*win
,
91 virtual void DrawDropArrow(wxWindow
*win
,
96 virtual void DrawCheckBox(wxWindow
*win
,
101 virtual wxSize
GetCheckBoxSize(wxWindow
*win
);
103 virtual void DrawPushButton(wxWindow
*win
,
108 virtual void DrawItemSelectionRect(wxWindow
*win
,
113 virtual void DrawFocusRect(wxWindow
* win
, wxDC
& dc
, const wxRect
& rect
, int flags
= 0);
115 virtual void DrawChoice(wxWindow
* win
, wxDC
& dc
, const wxRect
& rect
, int flags
=0);
117 virtual void DrawComboBox(wxWindow
* win
, wxDC
& dc
, const wxRect
& rect
, int flags
=0);
119 virtual void DrawTextCtrl(wxWindow
* win
, wxDC
& dc
, const wxRect
& rect
, int flags
=0);
121 virtual void DrawRadioBitmap(wxWindow
* win
, wxDC
& dc
, const wxRect
& rect
, int flags
=0);
123 virtual wxSplitterRenderParams
GetSplitterParams(const wxWindow
*win
);
125 virtual wxRendererVersion
GetVersion() const
127 return wxRendererVersion(wxRendererVersion::Current_Version
,
128 wxRendererVersion::Current_Age
);
132 // Cleanup by deleting standard renderer
133 static void Cleanup();
135 // Get the generic object
136 static wxRendererGeneric
* DoGetGeneric();
139 // draw the rectange using the first pen for the left and top sides and
140 // the second one for the bottom and right ones
141 void DrawShadedRect(wxDC
& dc
, wxRect
*rect
,
142 const wxPen
& pen1
, const wxPen
& pen2
);
150 static wxRendererGeneric
* sm_rendererGeneric
;
153 // ============================================================================
154 // wxRendererGeneric implementation
155 // ============================================================================
157 // Get the generic object
158 wxRendererGeneric
* wxRendererGeneric::DoGetGeneric()
160 if (!sm_rendererGeneric
)
161 sm_rendererGeneric
= new wxRendererGeneric
;
162 return sm_rendererGeneric
;
165 // ----------------------------------------------------------------------------
166 // wxRendererGeneric creation
167 // ----------------------------------------------------------------------------
170 wxRendererNative
& wxRendererNative::GetGeneric()
172 return * wxRendererGeneric::DoGetGeneric();
175 void wxRendererGeneric::Cleanup()
177 if (sm_rendererGeneric
)
178 delete sm_rendererGeneric
;
180 sm_rendererGeneric
= NULL
;
183 wxRendererGeneric
* wxRendererGeneric::sm_rendererGeneric
= NULL
;
185 wxRendererGeneric::wxRendererGeneric()
186 : m_penBlack(wxSystemSettings::GetColour(wxSYS_COLOUR_3DDKSHADOW
)),
187 m_penDarkGrey(wxSystemSettings::GetColour(wxSYS_COLOUR_3DSHADOW
)),
188 m_penLightGrey(wxSystemSettings::GetColour(wxSYS_COLOUR_3DFACE
)),
189 m_penHighlight(wxSystemSettings::GetColour(wxSYS_COLOUR_3DHIGHLIGHT
))
193 // ----------------------------------------------------------------------------
194 // wxRendererGeneric helpers
195 // ----------------------------------------------------------------------------
198 wxRendererGeneric::DrawShadedRect(wxDC
& dc
,
203 // draw the rectangle
205 dc
.DrawLine(rect
->GetLeft(), rect
->GetTop(),
206 rect
->GetLeft(), rect
->GetBottom());
207 dc
.DrawLine(rect
->GetLeft() + 1, rect
->GetTop(),
208 rect
->GetRight(), rect
->GetTop());
210 dc
.DrawLine(rect
->GetRight(), rect
->GetTop(),
211 rect
->GetRight(), rect
->GetBottom());
212 dc
.DrawLine(rect
->GetLeft(), rect
->GetBottom(),
213 rect
->GetRight() + 1, rect
->GetBottom());
219 // ----------------------------------------------------------------------------
220 // tree/list ctrl drawing
221 // ----------------------------------------------------------------------------
224 wxRendererGeneric::DrawHeaderButton(wxWindow
* win
,
228 wxHeaderSortIconType sortArrow
,
229 wxHeaderButtonParams
* params
)
231 const wxCoord x
= rect
.x
,
236 dc
.SetBrush(wxBrush(wxSystemSettings::GetColour(wxSYS_COLOUR_3DFACE
)));
237 dc
.SetPen(*wxTRANSPARENT_PEN
);
238 dc
.DrawRectangle(rect
);
240 dc
.SetBrush(*wxTRANSPARENT_BRUSH
);
242 dc
.SetPen(m_penBlack
);
243 dc
.DrawLine( x
+w
-1, y
, x
+w
-1, y
+h
); // right (outer)
244 dc
.DrawLine( x
, y
+h
-1, x
+w
, y
+h
-1 ); // bottom (outer)
246 dc
.SetPen(m_penDarkGrey
);
247 dc
.DrawLine( x
+w
-2, y
+1, x
+w
-2, y
+h
-1 ); // right (inner)
248 dc
.DrawLine( x
+1, y
+h
-2, x
+w
-1, y
+h
-2 ); // bottom (inner)
250 dc
.SetPen(m_penHighlight
);
251 dc
.DrawLine( x
, y
, x
, y
+h
-1 ); // left (outer)
252 dc
.DrawLine( x
, y
, x
+w
-1, y
); // top (outer)
254 return DrawHeaderButtonContents(win
, dc
, rect
, flags
, sortArrow
, params
);
259 wxRendererGeneric::DrawHeaderButtonContents(wxWindow
*win
,
263 wxHeaderSortIconType sortArrow
,
264 wxHeaderButtonParams
* params
)
268 // Mark this item as selected. For the generic version we'll just draw an
270 if ( flags
& wxCONTROL_SELECTED
)
272 // draw a line at the bottom of the header button, overlaying the
273 // native hot-tracking line (on XP)
274 const int penwidth
= 3;
275 int y
= rect
.y
+ rect
.height
+ 1 - penwidth
;
276 wxColour c
= (params
&& params
->m_selectionColour
.Ok()) ?
277 params
->m_selectionColour
: wxColour(0x66, 0x66, 0x66);
278 wxPen
pen(c
, penwidth
);
279 pen
.SetCap(wxCAP_BUTT
);
281 dc
.DrawLine(rect
.x
, y
, rect
.x
+ rect
.width
, y
);
284 // Draw an up or down arrow
286 if (sortArrow
!= wxHDR_SORT_ICON_NONE
)
290 // make a rect for the arrow
293 ar
.y
+= (rect
.height
- ar
.height
)/2;
294 ar
.x
= ar
.x
+ rect
.width
- 3*ar
.width
/2;
295 arrowSpace
= 3*ar
.width
/2; // space to preserve when drawing the label
298 if ( sortArrow
& wxHDR_SORT_ICON_UP
)
300 triPt
[0].x
= ar
.width
/ 2;
302 triPt
[1].x
= ar
.width
;
303 triPt
[1].y
= ar
.height
;
305 triPt
[2].y
= ar
.height
;
311 triPt
[1].x
= ar
.width
;
313 triPt
[2].x
= ar
.width
/ 2;
314 triPt
[2].y
= ar
.height
;
317 wxColour c
= (params
&& params
->m_arrowColour
.Ok()) ?
318 params
->m_arrowColour
: wxSystemSettings::GetColour(wxSYS_COLOUR_3DSHADOW
);
320 dc
.SetBrush(wxBrush(c
));
321 dc
.DrawPolygon( 3, triPt
, ar
.x
, ar
.y
);
323 labelWidth
+= arrowSpace
;
325 const int margin
= 5; // number of pixels to reserve on either side of the label
328 if ( params
&& params
->m_labelBitmap
.Ok() )
329 bmpWidth
= params
->m_labelBitmap
.GetWidth() + 2;
331 labelWidth
+= bmpWidth
+ 2*margin
;
333 // draw the bitmap if there is one
334 if ( params
&& params
->m_labelBitmap
.Ok() )
337 w
= params
->m_labelBitmap
.GetWidth();
338 h
= params
->m_labelBitmap
.GetHeight();
341 y
= rect
.y
+ wxMax(1, (rect
.height
- h
) / 2);
343 if (params
->m_labelText
.empty())
345 // use the alignment flags
346 switch (params
->m_labelAlignment
)
353 x
= rect
.x
+ wxMax(1, (rect
.width
- arrowSpace
- w
)/2);
356 x
= rect
.x
+ wxMax(1, rect
.width
- arrowSpace
- margin
- w
);
360 dc
.DrawBitmap(params
->m_labelBitmap
, x
, y
, true);
363 // Draw a label if one is given
364 if ( params
&& !params
->m_labelText
.empty() )
366 wxFont font
= params
->m_labelFont
.Ok() ?
367 params
->m_labelFont
: win
->GetFont();
368 wxColour clr
= params
->m_labelColour
.Ok() ?
369 params
->m_labelColour
: win
->GetForegroundColour();
371 wxString
label( params
->m_labelText
);
374 dc
.SetTextForeground(clr
);
375 dc
.SetBackgroundMode(wxBRUSHSTYLE_TRANSPARENT
);
377 int tw
, th
, td
, x
, y
;
378 dc
.GetTextExtent( label
, &tw
, &th
, &td
);
380 y
= rect
.y
+ wxMax(0, (rect
.height
- (th
+td
)) / 2);
382 y
+= 2; // No idea why.
385 // truncate and add an ellipsis (...) if the text is too wide.
386 int targetWidth
= rect
.width
- arrowSpace
- bmpWidth
- 2*margin
;
387 if ( tw
> targetWidth
)
390 dc
.GetTextExtent( wxT("..."), &ellipsisWidth
, NULL
);
392 label
.Truncate( label
.length() - 1 );
393 dc
.GetTextExtent( label
, &tw
, &th
);
394 } while (tw
+ ellipsisWidth
> targetWidth
&& label
.length() );
395 label
.append( wxT("...") );
399 switch (params
->m_labelAlignment
)
406 x
= rect
.x
+ wxMax(0, (rect
.width
- arrowSpace
- tw
- bmpWidth
)/2);
409 x
= rect
.x
+ wxMax(0, rect
.width
- arrowSpace
- margin
- tw
- bmpWidth
);
413 dc
.DrawText(label
, x
+ bmpWidth
, y
);
419 int wxRendererGeneric::GetHeaderButtonHeight(wxWindow
*win
)
421 // Copied and adapted from src/generic/listctrl.cpp
422 const int HEADER_OFFSET_Y
= 1;
423 const int EXTRA_HEIGHT
= 4;
427 win
->GetTextExtent(wxT("Hg"), &w
, &h
, &d
);
429 return h
+ d
+ 2 * HEADER_OFFSET_Y
+ EXTRA_HEIGHT
;
433 // draw the plus or minus sign
435 wxRendererGeneric::DrawTreeItemButton(wxWindow
* WXUNUSED(win
),
441 wxDCPenChanger
penChanger(dc
, *wxGREY_PEN
);
442 wxDCBrushChanger
brushChanger(dc
, *wxWHITE_BRUSH
);
444 dc
.DrawRectangle(rect
);
447 const wxCoord xMiddle
= rect
.x
+ rect
.width
/2;
448 const wxCoord yMiddle
= rect
.y
+ rect
.height
/2;
450 // half of the length of the horz lines in "-" and "+"
451 const wxCoord halfWidth
= rect
.width
/2 - 2;
452 dc
.SetPen(*wxBLACK_PEN
);
453 dc
.DrawLine(xMiddle
- halfWidth
, yMiddle
,
454 xMiddle
+ halfWidth
+ 1, yMiddle
);
456 if ( !(flags
& wxCONTROL_EXPANDED
) )
459 const wxCoord halfHeight
= rect
.height
/2 - 2;
460 dc
.DrawLine(xMiddle
, yMiddle
- halfHeight
,
461 xMiddle
, yMiddle
+ halfHeight
+ 1);
465 // ----------------------------------------------------------------------------
467 // ----------------------------------------------------------------------------
469 wxSplitterRenderParams
470 wxRendererGeneric::GetSplitterParams(const wxWindow
*win
)
476 if ( win
->HasFlag(wxSP_3DSASH
) )
478 else if ( win
->HasFlag(wxSP_NOSASH
) )
483 if ( win
->HasFlag(wxSP_3DBORDER
) )
488 return wxSplitterRenderParams(sashWidth
, border
, false);
492 wxRendererGeneric::DrawSplitterBorder(wxWindow
*win
,
494 const wxRect
& rectOrig
,
497 if ( win
->HasFlag(wxSP_3DBORDER
) )
499 wxRect rect
= rectOrig
;
500 DrawShadedRect(dc
, &rect
, m_penDarkGrey
, m_penHighlight
);
501 DrawShadedRect(dc
, &rect
, m_penBlack
, m_penLightGrey
);
506 wxRendererGeneric::DrawSplitterSash(wxWindow
*win
,
508 const wxSize
& sizeReal
,
510 wxOrientation orient
,
513 // to avoid duplicating the same code for horizontal and vertical sashes,
514 // simply mirror the DC instead if needed (i.e. if horz splitter)
515 wxMirrorDC
dc(dcReal
, orient
!= wxVERTICAL
);
516 wxSize size
= dc
.Reflect(sizeReal
);
519 // we draw a Win32-like grey sash with possible 3D border here:
521 // ---- this is position
526 // GWGGGDB where G is light grey (face)
527 // GWGGGDB W white (light)
528 // GWGGGDB D dark grey (shadow)
529 // GWGGGDB B black (dark shadow)
531 // GWGGGDB and lower letters are our border (already drawn)
535 // only the middle 3 columns are drawn unless wxSP_3D is specified
537 const wxCoord h
= size
.y
;
540 // If we're drawing the border, draw the sash 3d lines shorter
541 if ( win
->HasFlag(wxSP_3DBORDER
) )
546 dc
.SetPen(*wxTRANSPARENT_PEN
);
547 dc
.SetBrush(wxBrush(wxSystemSettings::GetColour(wxSYS_COLOUR_3DFACE
)));
549 if ( win
->HasFlag(wxSP_3DSASH
) )
552 dc
.DrawRectangle(position
+ 2, 0, 3, h
);
554 dc
.SetPen(m_penLightGrey
);
555 dc
.DrawLine(position
, offset
, position
, h
- offset
);
557 dc
.SetPen(m_penHighlight
);
558 dc
.DrawLine(position
+ 1, 0, position
+ 1, h
);
560 dc
.SetPen(m_penDarkGrey
);
561 dc
.DrawLine(position
+ 5, 0, position
+ 5, h
);
563 dc
.SetPen(m_penBlack
);
564 dc
.DrawLine(position
+ 6, offset
, position
+ 6, h
- offset
);
569 dc
.DrawRectangle(position
, 0, 3, h
);
573 // ----------------------------------------------------------------------------
575 // ----------------------------------------------------------------------------
578 wxRendererGeneric::DrawComboBoxDropButton(wxWindow
*win
,
583 DrawPushButton(win
,dc
,rect
,flags
);
584 DrawDropArrow(win
,dc
,rect
,flags
);
588 wxRendererGeneric::DrawDropArrow(wxWindow
*win
,
593 // This generic implementation should be good
594 // enough for Windows platforms (including XP).
596 int arrowHalf
= rect
.width
/5;
597 int rectMid
= rect
.width
/ 2;
598 int arrowTopY
= (rect
.height
/2) - (arrowHalf
/2);
600 // This should always result in arrow with odd width.
603 wxPoint(rectMid
- arrowHalf
, arrowTopY
),
604 wxPoint(rectMid
+ arrowHalf
, arrowTopY
),
605 wxPoint(rectMid
, arrowTopY
+ arrowHalf
)
607 dc
.SetBrush(wxBrush(win
->GetForegroundColour()));
608 dc
.SetPen(wxPen(win
->GetForegroundColour()));
609 dc
.DrawPolygon(WXSIZEOF(pt
), pt
, rect
.x
, rect
.y
);
613 wxRendererGeneric::DrawCheckBox(wxWindow
*WXUNUSED(win
),
618 dc
.SetPen(*(flags
& wxCONTROL_DISABLED
? wxGREY_PEN
: wxBLACK_PEN
));
619 dc
.SetBrush( *wxTRANSPARENT_BRUSH
);
620 dc
.DrawRectangle(rect
);
622 if ( flags
& wxCONTROL_CHECKED
)
624 dc
.DrawCheckMark(rect
.Deflate(2, 2));
628 wxSize
wxRendererGeneric::GetCheckBoxSize(wxWindow
*WXUNUSED(win
))
630 return wxSize(16, 16);
634 wxRendererGeneric::DrawPushButton(wxWindow
*win
,
639 // Don't try anything too fancy. It'll just turn out looking
640 // out-of-place on most platforms.
641 wxColour bgCol
= flags
& wxCONTROL_DISABLED
?
642 wxSystemSettings::GetColour(wxSYS_COLOUR_BTNFACE
) :
643 win
->GetBackgroundColour();
644 dc
.SetBrush(wxBrush(bgCol
));
645 dc
.SetPen(wxPen(bgCol
));
646 dc
.DrawRectangle(rect
);
650 wxRendererGeneric::DrawItemSelectionRect(wxWindow
* win
,
656 if ( flags
& wxCONTROL_SELECTED
)
658 if ( flags
& wxCONTROL_FOCUSED
)
660 brush
= wxBrush(wxSystemSettings::GetColour(wxSYS_COLOUR_HIGHLIGHT
));
664 brush
= wxBrush(wxSystemSettings::GetColour(wxSYS_COLOUR_BTNSHADOW
));
669 brush
= *wxTRANSPARENT_BRUSH
;
673 if ((flags
& wxCONTROL_CURRENT
) && (flags
& wxCONTROL_FOCUSED
)
674 #if defined( __WXMAC__ ) && !defined(__WXUNIVERSAL__) && wxOSX_USE_CARBON
675 && IsControlActive( (ControlRef
)win
->GetHandle() )
678 dc
.SetPen( *wxBLACK_PEN
);
680 dc
.SetPen( *wxTRANSPARENT_PEN
);
682 dc
.DrawRectangle( rect
);
684 // it's unused everywhere except in wxOSX/Carbon
689 wxRendererGeneric::DrawFocusRect(wxWindow
* WXUNUSED(win
), wxDC
& dc
, const wxRect
& rect
, int WXUNUSED(flags
))
691 // draw the pixels manually because the "dots" in wxPen with wxDOT style
692 // may be short traits and not really dots
694 // note that to behave in the same manner as DrawRect(), we must exclude
695 // the bottom and right borders from the rectangle
696 wxCoord x1
= rect
.GetLeft(),
698 x2
= rect
.GetRight(),
699 y2
= rect
.GetBottom();
701 dc
.SetPen(m_penBlack
);
704 dc
.SetLogicalFunction(wxCOPY
);
706 // this seems to be closer than what Windows does than wxINVERT although
707 // I'm still not sure if it's correct
708 dc
.SetLogicalFunction(wxAND_REVERSE
);
712 for ( z
= x1
+ 1; z
< x2
; z
+= 2 )
713 dc
.DrawPoint(z
, rect
.GetTop());
715 wxCoord shift
= z
== x2
? 0 : 1;
716 for ( z
= y1
+ shift
; z
< y2
; z
+= 2 )
719 shift
= z
== y2
? 0 : 1;
720 for ( z
= x2
- shift
; z
> x1
; z
-= 2 )
723 shift
= z
== x1
? 0 : 1;
724 for ( z
= y2
- shift
; z
> y1
; z
-= 2 )
727 dc
.SetLogicalFunction(wxCOPY
);
730 void wxRendererGeneric::DrawChoice(wxWindow
* WXUNUSED(win
), wxDC
& WXUNUSED(dc
),
731 const wxRect
& WXUNUSED(rect
), int WXUNUSED(flags
))
733 wxFAIL_MSG("UNIMPLEMENTED: wxRendererGeneric::DrawChoice");
736 void wxRendererGeneric::DrawComboBox(wxWindow
* WXUNUSED(win
), wxDC
& WXUNUSED(dc
),
737 const wxRect
& WXUNUSED(rect
), int WXUNUSED(flags
))
739 wxFAIL_MSG("UNIMPLEMENTED: wxRendererGeneric::DrawComboBox");
742 void wxRendererGeneric::DrawRadioBitmap(wxWindow
* WXUNUSED(win
), wxDC
& WXUNUSED(dc
),
743 const wxRect
& WXUNUSED(rect
), int WXUNUSED(flags
))
745 wxFAIL_MSG("UNIMPLEMENTED: wxRendererGeneric::DrawRadioBitmap");
748 void wxRendererGeneric::DrawTextCtrl(wxWindow
* WXUNUSED(win
), wxDC
& WXUNUSED(dc
),
749 const wxRect
& WXUNUSED(rect
), int WXUNUSED(flags
))
751 wxFAIL_MSG("UNIMPLEMENTED: wxRendererGeneric::DrawTextCtrl");
757 // ----------------------------------------------------------------------------
758 // A module to allow cleanup of generic renderer.
759 // ----------------------------------------------------------------------------
761 class wxGenericRendererModule
: public wxModule
763 DECLARE_DYNAMIC_CLASS(wxGenericRendererModule
)
765 wxGenericRendererModule() {}
766 bool OnInit() { return true; }
767 void OnExit() { wxRendererGeneric::Cleanup(); }
770 IMPLEMENT_DYNAMIC_CLASS(wxGenericRendererModule
, wxModule
)