]> git.saurik.com Git - wxWidgets.git/blob - include/wx/univ/theme.h
Trying to hide evidence of my negative programming skills...
[wxWidgets.git] / include / wx / univ / theme.h
1 ///////////////////////////////////////////////////////////////////////////////
2 // Name: wx/univ/theme.h
3 // Purpose: wxTheme class manages all configurable aspects of the
4 // application including the look (wxRenderer), feel
5 // (wxInputHandler) and the colours (wxColourScheme)
6 // Author: Vadim Zeitlin
7 // Modified by:
8 // Created: 06.08.00
9 // RCS-ID: $Id$
10 // Copyright: (c) 2000 SciTech Software, Inc. (www.scitechsoft.com)
11 // Licence: wxWindows license
12 ///////////////////////////////////////////////////////////////////////////////
13
14 #ifndef _WX_UNIV_THEME_H_
15 #define _WX_UNIV_THEME_H_
16
17 #ifdef __GNUG__
18 #pragma interface "theme.h"
19 #endif
20
21 // ----------------------------------------------------------------------------
22 // wxTheme
23 // ----------------------------------------------------------------------------
24
25 class WXDLLEXPORT wxRenderer;
26 class WXDLLEXPORT wxColourScheme;
27 class WXDLLEXPORT wxInputHandler;
28 struct WXDLLEXPORT wxThemeInfo;
29
30 class WXDLLEXPORT wxTheme
31 {
32 public:
33 // static methods
34 // --------------
35
36 // create the default theme
37 static bool CreateDefault();
38
39 // create the theme by name (will return NULL if not found)
40 static wxTheme *Create(const wxString& name);
41
42 // change the current scheme
43 static wxTheme *Set(wxTheme *theme);
44
45 // get the current theme (never NULL)
46 static wxTheme *Get() { return ms_theme; }
47
48 // the theme methods
49 // -----------------
50
51 // get the renderer implementing all the control-drawing operations in
52 // this theme
53 virtual wxRenderer *GetRenderer() = 0;
54
55 // get the input handler of the given type
56 virtual wxInputHandler *GetInputHandler(const wxString& handlerType) = 0;
57
58 // get the colour scheme for the control with this name
59 virtual wxColourScheme *GetColourScheme() = 0;
60
61 // implementation only from now on
62 // -------------------------------
63
64 virtual ~wxTheme();
65
66 private:
67 // the list of descriptions of all known themes
68 static wxThemeInfo *ms_allThemes;
69
70 // the current theme
71 static wxTheme *ms_theme;
72 #ifdef __MWERKS__
73 friend class wxThemeInfo;
74 #else
75 friend wxThemeInfo;
76 #endif
77 };
78
79 // ----------------------------------------------------------------------------
80 // dynamic theme creation helpers
81 // ----------------------------------------------------------------------------
82
83 struct WXDLLEXPORT wxThemeInfo
84 {
85 typedef wxTheme *(*Constructor)();
86
87 // theme name and (user readable) description
88 wxString name, desc;
89
90 // the function to create a theme object
91 Constructor ctor;
92
93 // next node in the linked list or NULL
94 wxThemeInfo *next;
95
96 // constructor for the struct itself
97 wxThemeInfo(Constructor ctor, const wxChar *name, const wxChar *desc);
98 };
99
100 // ----------------------------------------------------------------------------
101 // macros
102 // ----------------------------------------------------------------------------
103
104 // to use a standard theme insert this macro into one of the application files:
105 // without it, an over optimizing linker may discard the object module
106 // containing the theme implementation entirely
107 #define WX_USE_THEME(themename) \
108 extern bool wxThemeUse##themename; \
109 static struct wxThemeUserFor##themename \
110 { \
111 wxThemeUserFor##themename() { wxThemeUse##themename = TRUE; } \
112 } wxThemeDoUse##themename
113
114 // to declare a new theme, this macro must be used in the class declaration
115 #define WX_DECLARE_THEME(themename) \
116 private: \
117 static wxThemeInfo ms_info##themename; \
118 public: \
119 const wxThemeInfo *GetThemeInfo() const \
120 { return &ms_info##themename; }
121
122 // and this one must be inserted in the source file
123 #define WX_IMPLEMENT_THEME(classname, themename, themedesc) \
124 bool wxThemeUse##themename = TRUE; \
125 wxTheme *wxCtorFor##themename() { return new classname; } \
126 wxThemeInfo classname::ms_info##themename(wxCtorFor##themename, \
127 #themename, themedesc)
128
129 #endif // _WX_UNIV_THEME_H_
130