X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/df02852424b38b483c4c072eb1df6ac35825153c..2d97237dac7f35e78f4a1ce1877dafc7b05ffb4f:/include/wx/univ/renderer.h diff --git a/include/wx/univ/renderer.h b/include/wx/univ/renderer.h index f1c705542e..1db8d9e190 100644 --- a/include/wx/univ/renderer.h +++ b/include/wx/univ/renderer.h @@ -6,11 +6,14 @@ // Created: 06.08.00 // RCS-ID: $Id$ // Copyright: (c) 2000 SciTech Software, Inc. (www.scitechsoft.com) -// Licence: wxWindows license +// Licence: wxWindows licence /////////////////////////////////////////////////////////////////////////////// +#ifndef _WX_UNIV_RENDERER_H_ +#define _WX_UNIV_RENDERER_H_ + /* - wxRenderer class is used to draw all wxWindows controls. This is an ABC and + wxRenderer class is used to draw all wxWidgets controls. This is an ABC and the look of the application is determined by the concrete derivation of wxRenderer used in the program. @@ -18,26 +21,36 @@ renderers and provide the functionality which is often similar or identical in all renderers (using inheritance here would be more restrictive as the given concrete renderer may need an arbitrary subset of the base class - methods) - */ + methods). -#ifdef __GNUG__ - #pragma interface "renderer.h" -#endif + Finally note that wxRenderer supersedes wxRendererNative in wxUniv build and + includes the latters functionality (which it may delegate to the generic + implementation of the latter or reimplement itself). + */ -#ifndef _WX_UNIV_RENDERER_H_ -#define _WX_UNIV_RENDERER_H_ +#include "wx/renderer.h" +class WXDLLEXPORT wxWindow; class WXDLLEXPORT wxDC; class WXDLLEXPORT wxCheckListBox; -class WXDLLEXPORT wxListBox; -class WXDLLEXPORT wxMenu; -class WXDLLEXPORT wxMenuGeometryInfo; + +#if wxUSE_LISTBOX + class WXDLLEXPORT wxListBox; +#endif // wxUSE_LISTBOX + +#if wxUSE_MENUS + class WXDLLEXPORT wxMenu; + class WXDLLEXPORT wxMenuGeometryInfo; +#endif // wxUSE_MENUS + class WXDLLEXPORT wxScrollBar; -class WXDLLEXPORT wxTextCtrl; -class WXDLLEXPORT wxWindow; + +#if wxUSE_TEXTCTRL + class WXDLLEXPORT wxTextCtrl; +#endif + #if wxUSE_GAUGE -class WXDLLEXPORT wxGauge; + class WXDLLEXPORT wxGauge; #endif // wxUSE_GAUGE #include "wx/string.h" @@ -59,7 +72,7 @@ public: // wxRenderer: abstract renderers interface // ---------------------------------------------------------------------------- -class WXDLLEXPORT wxRenderer +class WXDLLEXPORT wxRenderer : public wxDelegateRendererNative { public: // drawing functions @@ -69,7 +82,16 @@ public: virtual void DrawBackground(wxDC& dc, const wxColour& col, const wxRect& rect, - int flags) = 0; + int flags, + wxWindow *window = NULL ) = 0; + + // draw the button surface + virtual void DrawButtonSurface(wxDC& dc, + const wxColour& col, + const wxRect& rect, + int flags ) + { DrawBackground( dc, col, rect, flags ); } + // draw the label inside the given rectangle with the specified alignment // and optionally emphasize the character with the given index @@ -100,7 +122,7 @@ public: wxRect *rectIn = (wxRect *)NULL) = 0; // draw text control border (I hate to have a separate method for this but - // it is needed to accomodate GTK+) + // it is needed to accommodate GTK+) virtual void DrawTextBorder(wxDC& dc, wxBorder border, const wxRect& rect, @@ -188,6 +210,18 @@ public: wxAlignment align = wxALIGN_LEFT, int indexAccel = -1) = 0; +#if wxUSE_TOOLBAR + // draw a toolbar button (label may be empty, bitmap may be invalid, if + // both conditions are true this function draws a separator) + virtual void DrawToolBarButton(wxDC& dc, + const wxString& label, + const wxBitmap& bitmap, + const wxRect& rect, + int flags = 0, + long style = 0, + int tbarStyle = 0) = 0; +#endif // wxUSE_TOOLBAR + // draw a (part of) line in the text control virtual void DrawTextLine(wxDC& dc, const wxString& text, @@ -208,29 +242,37 @@ public: int flags = 0, int indexAccel = -1) = 0; +#if wxUSE_SLIDER + // draw the slider shaft virtual void DrawSliderShaft(wxDC& dc, const wxRect& rect, + int lenThumb, wxOrientation orient, int flags = 0, + long style = 0, wxRect *rectShaft = NULL) = 0; // draw the slider thumb virtual void DrawSliderThumb(wxDC& dc, const wxRect& rect, wxOrientation orient, - int flags = 0) = 0; + int flags = 0, + long style = 0) = 0; // draw the slider ticks virtual void DrawSliderTicks(wxDC& dc, const wxRect& rect, - const wxSize& sizeThumb, + int lenThumb, wxOrientation orient, int start, int end, int step = 1, - int flags = 0) = 0; + int flags = 0, + long style = 0) = 0; +#endif // wxUSE_SLIDER +#if wxUSE_MENUS // draw a menu bar item virtual void DrawMenuBarItem(wxDC& dc, const wxRect& rect, @@ -254,13 +296,16 @@ public: virtual void DrawMenuSeparator(wxDC& dc, wxCoord y, const wxMenuGeometryInfo& geomInfo) = 0; +#endif // wxUSE_MENUS +#if wxUSE_STATUSBAR // draw a status bar field: wxCONTROL_ISDEFAULT bit in the flags is // interpreted specially and means "draw the status bar grip" here virtual void DrawStatusField(wxDC& dc, const wxRect& rect, const wxString& label, - int flags = 0) = 0; + int flags = 0, int style = 0) = 0; +#endif // wxUSE_STATUSBAR // draw complete frame/dialog titlebar virtual void DrawFrameTitleBar(wxDC& dc, @@ -325,6 +370,8 @@ public: // the control looks "nice" if it uses the adjusted rectangle virtual void AdjustSize(wxSize *size, const wxWindow *window) = 0; +#if wxUSE_SCROLLBAR + // get the size of a scrollbar arrow virtual wxSize GetScrollbarArrowSize() const = 0; @@ -348,6 +395,8 @@ public: virtual int PixelToScrollbar(const wxScrollBar *scrollbar, wxCoord coord) = 0; +#endif // wxUSE_SCROLLBAR + // get the height of a listbox item from the base font height virtual wxCoord GetListboxItemHeight(wxCoord fontHeight) = 0; @@ -356,15 +405,24 @@ public: virtual wxSize GetRadioBitmapSize() const = 0; virtual wxCoord GetCheckItemMargin() const = 0; + // get the standard size of a toolbar button and also return the size of + // a toolbar separator in the provided pointer + virtual wxSize GetToolBarButtonSize(wxCoord *separator) const = 0; + + // get the margins between/around the toolbar buttons + virtual wxSize GetToolBarMargin() const = 0; + +#if wxUSE_TEXTCTRL // convert between text rectangle and client rectangle for text controls: // the former is typicall smaller to leave margins around text virtual wxRect GetTextTotalArea(const wxTextCtrl *text, - const wxRect& rectText) = 0; + const wxRect& rectText) const = 0; // extra space is for line indicators virtual wxRect GetTextClientArea(const wxTextCtrl *text, const wxRect& rectTotal, - wxCoord *extraSpaceBeyond) = 0; + wxCoord *extraSpaceBeyond) const = 0; +#endif // wxUSE_TEXTCTRL // get the overhang of a selected tab virtual wxSize GetTabIndent() const = 0; @@ -372,6 +430,7 @@ public: // get the padding around the text in a tab virtual wxSize GetTabPadding() const = 0; +#if wxUSE_SLIDER // get the default size of the slider in lesser dimension (i.e. height of a // horizontal slider or width of a vertical one) virtual wxCoord GetSliderDim() const = 0; @@ -381,15 +440,20 @@ public: // get the slider shaft rect from the total slider rect virtual wxRect GetSliderShaftRect(const wxRect& rect, - wxOrientation orient) const = 0; + int lenThumb, + wxOrientation orient, + long style = 0) const = 0; // get the size of the slider thumb for the given total slider rect virtual wxSize GetSliderThumbSize(const wxRect& rect, + int lenThumb, wxOrientation orient) const = 0; +#endif // wxUSE_SLIDER // get the size of one progress bar step (in horz and vertical directions) virtual wxSize GetProgressBarStep() const = 0; +#if wxUSE_MENUS // get the size of rectangle to use in the menubar for the given text rect virtual wxSize GetMenuBarItemSize(const wxSize& sizeText) const = 0; @@ -400,10 +464,13 @@ public: // the returned pointer must be deleted by the caller virtual wxMenuGeometryInfo *GetMenuGeometry(wxWindow *win, const wxMenu& menu) const = 0; +#endif // wxUSE_MENUS +#if wxUSE_STATUSBAR // get the borders around the status bar fields (x and y fields of the // return value) and also, optionally, the border between the fields virtual wxSize GetStatusBarBorders(wxCoord *borderBetweenFields) const = 0; +#endif // wxUSE_STATUSBAR // get client area rectangle of top level window (i.e. subtract // decorations from given rectangle) @@ -412,6 +479,9 @@ public: // get size of whole top level window, given size of its client area size virtual wxSize GetFrameTotalSize(const wxSize& clientSize, int flags) const = 0; + // get the minimal size of top level window + virtual wxSize GetFrameMinSize(int flags) const = 0; + // get titlebar icon size virtual wxSize GetFrameIconSize() const = 0; @@ -420,15 +490,10 @@ public: const wxPoint& pt, int flags = 0) const = 0; - - // get the standard icon used by wxWin dialogs - this allows the user - // to customize the standard dialogs. The 'which' parameter is one of - // wxICON_XXX values - virtual wxIcon GetStdIcon(int which) const = 0; - // virtual dtor for any base class virtual ~wxRenderer(); + protected: // draw a frame around rectFrame rectangle but not touching the rectLabel // one: this is used by DrawFrame() @@ -444,6 +509,7 @@ protected: int selStart, int selEnd, int flags); +#if wxUSE_SCROLLBAR // standard scrollbar hit testing: this assumes that it only has 2 arrows // and a thumb, so the themes which have more complicated scrollbars (e.g. // BeOS) can't use this method @@ -468,6 +534,8 @@ protected: int range, wxCoord *thumbStart, wxCoord *thumbEnd); +#endif // wxUSE_SCROLLBAR + }; // ---------------------------------------------------------------------------- @@ -485,8 +553,9 @@ public: virtual void DrawBackground(wxDC& dc, const wxColour& col, const wxRect& rect, - int flags) - { m_renderer->DrawBackground(dc, col, rect, flags); } + int flags, + wxWindow *window = NULL ) + { m_renderer->DrawBackground(dc, col, rect, flags, window ); } virtual void DrawLabel(wxDC& dc, const wxString& label, const wxRect& rect, @@ -588,12 +657,23 @@ public: int indexAccel = -1) { m_renderer->DrawRadioButton(dc, label, bitmap, rect, flags, align, indexAccel); } +#if wxUSE_TOOLBAR + virtual void DrawToolBarButton(wxDC& dc, + const wxString& label, + const wxBitmap& bitmap, + const wxRect& rect, + int flags = 0, + long style = 0, + int tbarStyle = 0) + { m_renderer->DrawToolBarButton(dc, label, bitmap, rect, flags, style, tbarStyle); } +#endif // wxUSE_TOOLBAR virtual void DrawTextLine(wxDC& dc, const wxString& text, const wxRect& rect, int selStart = -1, - int selEnd = -1) - { m_renderer->DrawTextLine(dc, text, rect, selStart, selEnd); } + int selEnd = -1, + int flags = 0) + { m_renderer->DrawTextLine(dc, text, rect, selStart, selEnd, flags); } virtual void DrawLineWrapMark(wxDC& dc, const wxRect& rect) { m_renderer->DrawLineWrapMark(dc, rect); } @@ -606,28 +686,36 @@ public: int accel = -1) { m_renderer->DrawTab(dc, rect, dir, label, bitmap, flags, accel); } +#if wxUSE_SLIDER + virtual void DrawSliderShaft(wxDC& dc, const wxRect& rect, + int lenThumb, wxOrientation orient, int flags = 0, + long style = 0, wxRect *rectShaft = NULL) - { m_renderer->DrawSliderShaft(dc, rect, orient, flags, rectShaft); } + { m_renderer->DrawSliderShaft(dc, rect, lenThumb, orient, flags, style, rectShaft); } virtual void DrawSliderThumb(wxDC& dc, const wxRect& rect, wxOrientation orient, - int flags = 0) - { m_renderer->DrawSliderThumb(dc, rect, orient, flags); } + int flags = 0, + long style = 0) + { m_renderer->DrawSliderThumb(dc, rect, orient, flags, style); } virtual void DrawSliderTicks(wxDC& dc, const wxRect& rect, - const wxSize& sizeThumb, + int lenThumb, wxOrientation orient, int start, int end, - int step = 1, - int flags = 0) - { m_renderer->DrawSliderTicks(dc, rect, sizeThumb, orient, - start, end, start, flags); } + int WXUNUSED(step) = 1, + int flags = 0, + long style = 0) + { m_renderer->DrawSliderTicks(dc, rect, lenThumb, orient, + start, end, start, flags, style); } +#endif // wxUSE_SLIDER +#if wxUSE_MENUS virtual void DrawMenuBarItem(wxDC& dc, const wxRect& rect, const wxString& label, @@ -648,12 +736,15 @@ public: wxCoord y, const wxMenuGeometryInfo& geomInfo) { m_renderer->DrawMenuSeparator(dc, y, geomInfo); } +#endif // wxUSE_MENUS +#if wxUSE_STATUSBAR virtual void DrawStatusField(wxDC& dc, const wxRect& rect, const wxString& label, - int flags = 0) - { m_renderer->DrawStatusField(dc, rect, label, flags); } + int flags = 0, int style = 0) + { m_renderer->DrawStatusField(dc, rect, label, flags, style); } +#endif // wxUSE_STATUSBAR virtual void DrawFrameTitleBar(wxDC& dc, const wxRect& rect, @@ -691,7 +782,7 @@ public: virtual void GetComboBitmaps(wxBitmap *bmpNormal, wxBitmap *bmpFocus, wxBitmap *bmpPressed, - wxBitmap *bmpDisabled) const + wxBitmap *bmpDisabled) { m_renderer->GetComboBitmaps(bmpNormal, bmpFocus, bmpPressed, bmpDisabled); } @@ -702,6 +793,7 @@ public: virtual bool AreScrollbarsInsideBorder() const { return m_renderer->AreScrollbarsInsideBorder(); } +#if wxUSE_SCROLLBAR virtual wxSize GetScrollbarArrowSize() const { return m_renderer->GetScrollbarArrowSize(); } virtual wxRect GetScrollbarRect(const wxScrollBar *scrollbar, @@ -719,6 +811,8 @@ public: virtual int PixelToScrollbar(const wxScrollBar *scrollbar, wxCoord coord) { return m_renderer->PixelToScrollbar(scrollbar, coord); } +#endif // wxUSE_SCROLLBAR + virtual wxCoord GetListboxItemHeight(wxCoord fontHeight) { return m_renderer->GetListboxItemHeight(fontHeight); } virtual wxSize GetCheckBitmapSize() const @@ -728,47 +822,79 @@ public: virtual wxCoord GetCheckItemMargin() const { return m_renderer->GetCheckItemMargin(); } - virtual wxRect GetTextTotalArea(const wxTextCtrl *text, const wxRect& rect) + virtual wxSize GetToolBarButtonSize(wxCoord *separator) const + { return m_renderer->GetToolBarButtonSize(separator); } + virtual wxSize GetToolBarMargin() const + { return m_renderer->GetToolBarMargin(); } + +#if wxUSE_TEXTCTRL + virtual wxRect GetTextTotalArea(const wxTextCtrl *text, + const wxRect& rect) const { return m_renderer->GetTextTotalArea(text, rect); } virtual wxRect GetTextClientArea(const wxTextCtrl *text, const wxRect& rect, - wxCoord *extraSpaceBeyond) + wxCoord *extraSpaceBeyond) const { return m_renderer->GetTextClientArea(text, rect, extraSpaceBeyond); } +#endif // wxUSE_TEXTCTRL virtual wxSize GetTabIndent() const { return m_renderer->GetTabIndent(); } virtual wxSize GetTabPadding() const { return m_renderer->GetTabPadding(); } +#if wxUSE_SLIDER virtual wxCoord GetSliderDim() const { return m_renderer->GetSliderDim(); } virtual wxCoord GetSliderTickLen() const { return m_renderer->GetSliderTickLen(); } + virtual wxRect GetSliderShaftRect(const wxRect& rect, - wxOrientation orient) const - { return GetSliderShaftRect(rect, orient); } + int lenThumb, + wxOrientation orient, + long style = 0) const + { return m_renderer->GetSliderShaftRect(rect, lenThumb, orient, style); } virtual wxSize GetSliderThumbSize(const wxRect& rect, + int lenThumb, wxOrientation orient) const - { return m_renderer->GetSliderThumbSize(rect, orient); } + { return m_renderer->GetSliderThumbSize(rect, lenThumb, orient); } +#endif // wxUSE_SLIDER + virtual wxSize GetProgressBarStep() const { return m_renderer->GetProgressBarStep(); } + +#if wxUSE_MENUS virtual wxSize GetMenuBarItemSize(const wxSize& sizeText) const { return m_renderer->GetMenuBarItemSize(sizeText); } virtual wxMenuGeometryInfo *GetMenuGeometry(wxWindow *win, const wxMenu& menu) const { return m_renderer->GetMenuGeometry(win, menu); } +#endif // wxUSE_MENUS + +#if wxUSE_STATUSBAR virtual wxSize GetStatusBarBorders(wxCoord *borderBetweenFields) const { return m_renderer->GetStatusBarBorders(borderBetweenFields); } +#endif // wxUSE_STATUSBAR virtual wxRect GetFrameClientArea(const wxRect& rect, int flags) const { return m_renderer->GetFrameClientArea(rect, flags); } virtual wxSize GetFrameTotalSize(const wxSize& clientSize, int flags) const { return m_renderer->GetFrameTotalSize(clientSize, flags); } + virtual wxSize GetFrameMinSize(int flags) const + { return m_renderer->GetFrameMinSize(flags); } virtual wxSize GetFrameIconSize() const { return m_renderer->GetFrameIconSize(); } virtual int HitTestFrame(const wxRect& rect, const wxPoint& pt, int flags) const { return m_renderer->HitTestFrame(rect, pt, flags); } - virtual wxIcon GetStdIcon(int which) const - { return m_renderer->GetStdIcon(which); } + + virtual void DrawHeaderButton(wxWindow *win, + wxDC& dc, + const wxRect& rect, + int flags = 0) + { m_renderer->DrawHeaderButton(win, dc, rect, flags); } + virtual void DrawTreeItemButton(wxWindow *win, + wxDC& dc, + const wxRect& rect, + int flags = 0) + { m_renderer->DrawTreeItemButton(win, dc, rect, flags); } protected: wxRenderer *m_renderer; @@ -825,10 +951,13 @@ public: wxStretch stretch = wxSTRETCH_NOT); private: + +#if wxUSE_LISTBOX // common part of DrawItems() and DrawCheckItems() void DoDrawItems(const wxListBox *listbox, size_t itemFirst, size_t itemLast, - bool isCheckLbox = FALSE); + bool isCheckLbox = false); +#endif // wxUSE_LISTBOX wxWindow *m_window; wxRenderer *m_renderer; @@ -837,4 +966,3 @@ private: }; #endif // _WX_UNIV_RENDERER_H_ -