]>
Commit | Line | Data |
---|---|---|
c801d85f KB |
1 | ///////////////////////////////////////////////////////////////////////////// |
2 | // Name: object.h | |
3 | // Purpose: wxObject class, plus run-time type information macros | |
4 | // Author: Julian Smart | |
5 | // Modified by: | |
6 | // Created: 01/02/97 | |
7 | // RCS-ID: $Id$ | |
8 | // Copyright: (c) Julian Smart and Markus Holzem | |
3f4a0c5b | 9 | // Licence: wxWindows licence |
c801d85f KB |
10 | ///////////////////////////////////////////////////////////////////////////// |
11 | ||
34138703 JS |
12 | #ifndef _WX_OBJECTH__ |
13 | #define _WX_OBJECTH__ | |
c801d85f KB |
14 | |
15 | #ifdef __GNUG__ | |
0d3820b3 | 16 | #pragma interface "object.h" |
c801d85f KB |
17 | #endif |
18 | ||
19 | #include "wx/defs.h" | |
e55ad60e | 20 | #include "wx/memory.h" |
c801d85f KB |
21 | |
22 | class WXDLLEXPORT wxObject; | |
23 | ||
47d67540 | 24 | #if wxUSE_DYNAMIC_CLASSES |
c801d85f | 25 | |
3f1af920 | 26 | // #ifdef __GNUWIN32__ |
c801d85f KB |
27 | #ifdef GetClassName |
28 | #undef GetClassName | |
29 | #endif | |
3f1af920 JS |
30 | #ifdef GetClassInfo |
31 | #undef GetClassInfo | |
c801d85f | 32 | #endif |
3f1af920 | 33 | // #endif |
c801d85f KB |
34 | |
35 | class WXDLLEXPORT wxClassInfo; | |
1678ad78 | 36 | class WXDLLEXPORT wxInputStream; |
858f7d66 | 37 | class WXDLLEXPORT wxOutputStream; |
f4a8c29f GL |
38 | class WXDLLEXPORT wxObjectInputStream; |
39 | class WXDLLEXPORT wxObjectOutputStream; | |
40 | class WXDLLEXPORT wxHashTable; | |
41 | class WXDLLEXPORT wxObject_Serialize; | |
c801d85f | 42 | |
38830220 RR |
43 | #if wxUSE_STD_IOSTREAM && (defined(__WXDEBUG__) || wxUSE_DEBUG_CONTEXT) |
44 | #include "wx/ioswrap.h" | |
fbc535ff JS |
45 | #endif |
46 | ||
c801d85f KB |
47 | /* |
48 | * Dynamic object system declarations | |
49 | */ | |
50 | ||
51 | typedef wxObject * (*wxObjectConstructorFn) (void); | |
52 | ||
c801d85f KB |
53 | class WXDLLEXPORT wxClassInfo |
54 | { | |
55 | public: | |
9d2f3c71 | 56 | wxClassInfo(wxChar *cName, wxChar *baseName1, wxChar *baseName2, int sz, wxObjectConstructorFn fn); |
c801d85f KB |
57 | |
58 | wxObject *CreateObject(void); | |
3f4a0c5b | 59 | |
9d2f3c71 OK |
60 | inline wxChar *GetClassName(void) const { return m_className; } |
61 | inline wxChar *GetBaseClassName1(void) const { return m_baseClassName1; } | |
62 | inline wxChar *GetBaseClassName2(void) const { return m_baseClassName2; } | |
0c32066b JS |
63 | inline wxClassInfo* GetBaseClass1() const { return m_baseInfo1; } |
64 | inline wxClassInfo* GetBaseClass2() const { return m_baseInfo2; } | |
65 | inline int GetSize(void) const { return m_objectSize; } | |
66 | inline wxObjectConstructorFn GetConstructor() const { return m_objectConstructor; } | |
856d2e52 | 67 | static inline wxClassInfo* GetFirst() { return sm_first; } |
0c32066b | 68 | inline wxClassInfo* GetNext() const { return m_next; } |
8cb50e4b | 69 | bool IsKindOf(wxClassInfo *info) const; |
c801d85f | 70 | |
9d2f3c71 | 71 | static wxClassInfo *FindClass(wxChar *c); |
0c32066b JS |
72 | |
73 | // Initializes parent pointers and hash table for fast searching. | |
c801d85f | 74 | static void InitializeClasses(void); |
0c32066b JS |
75 | |
76 | // Cleans up hash table used for fast searching. | |
77 | static void CleanUpClasses(void); | |
78 | ||
79 | public: | |
9d2f3c71 OK |
80 | wxChar* m_className; |
81 | wxChar* m_baseClassName1; | |
82 | wxChar* m_baseClassName2; | |
0c32066b JS |
83 | int m_objectSize; |
84 | wxObjectConstructorFn m_objectConstructor; | |
3f4a0c5b | 85 | |
0c32066b JS |
86 | // Pointers to base wxClassInfos: set in InitializeClasses |
87 | // called from wx_main.cc | |
88 | wxClassInfo* m_baseInfo1; | |
89 | wxClassInfo* m_baseInfo2; | |
90 | ||
91 | static wxClassInfo* sm_first; | |
92 | wxClassInfo* m_next; | |
93 | ||
94 | static wxHashTable* sm_classTable; | |
c801d85f KB |
95 | }; |
96 | ||
9d2f3c71 | 97 | WXDLLEXPORT wxObject* wxCreateDynamicObject(const wxChar *name); |
c801d85f | 98 | |
9838df2c | 99 | #if wxUSE_SERIAL |
184b5d99 | 100 | WXDLLEXPORT wxObject* wxCreateStoredObject( wxInputStream& stream ); |
c801d85f KB |
101 | #endif |
102 | ||
103 | #define DECLARE_DYNAMIC_CLASS(name) \ | |
104 | public:\ | |
0c32066b | 105 | static wxClassInfo sm_class##name;\ |
8cb50e4b | 106 | wxClassInfo *GetClassInfo() const \ |
0c32066b | 107 | { return &name::sm_class##name; } |
c801d85f KB |
108 | |
109 | #define DECLARE_ABSTRACT_CLASS(name) DECLARE_DYNAMIC_CLASS(name) | |
110 | #define DECLARE_CLASS(name) DECLARE_DYNAMIC_CLASS(name) | |
111 | ||
c801d85f KB |
112 | ////// |
113 | ////// for concrete classes | |
114 | ////// | |
115 | ||
116 | // Single inheritance with one base class | |
117 | #define IMPLEMENT_DYNAMIC_CLASS(name, basename) \ | |
5fde6fcc | 118 | wxObject* WXDLLEXPORT_CTORFN wxConstructorFor##name(void); \ |
c801d85f KB |
119 | wxObject* WXDLLEXPORT_CTORFN wxConstructorFor##name(void) \ |
120 | { return new name; }\ | |
223d09f6 | 121 | wxClassInfo name::sm_class##name((wxChar *) wxT(#name), (wxChar *) wxT(#basename), (wxChar *) NULL, (int) sizeof(name), (wxObjectConstructorFn) wxConstructorFor##name); |
c801d85f KB |
122 | |
123 | // Multiple inheritance with two base classes | |
124 | #define IMPLEMENT_DYNAMIC_CLASS2(name, basename1, basename2) \ | |
125 | wxObject* WXDLLEXPORT_CTORFN wxConstructorFor##name(void) \ | |
126 | { return new name; }\ | |
223d09f6 | 127 | wxClassInfo name::sm_class##name((wxChar *) wxT(#name), (wxChar *) wxT(#basename1), (wxChar *) wxT(#basename2), (int) sizeof(name), (wxObjectConstructorFn) wxConstructorFor##name); |
c801d85f | 128 | |
c801d85f KB |
129 | ////// |
130 | ////// for abstract classes | |
131 | ////// | |
132 | ||
133 | // Single inheritance with one base class | |
134 | #define IMPLEMENT_ABSTRACT_CLASS(name, basename) \ | |
223d09f6 | 135 | wxClassInfo name::sm_class##name((wxChar *) wxT(#name), (wxChar *) wxT(#basename), \ |
34636400 | 136 | (wxChar *) NULL, (int) sizeof(name), (wxObjectConstructorFn) NULL); |
c801d85f KB |
137 | |
138 | // Multiple inheritance with two base classes | |
139 | #define IMPLEMENT_ABSTRACT_CLASS2(name, basename1, basename2) \ | |
223d09f6 KB |
140 | wxClassInfo name::sm_class##name((wxChar *) wxT(#name), (wxChar *) wxT(#basename1), \ |
141 | (wxChar *) wxT(#basename2), (int) sizeof(name), (wxObjectConstructorFn) NULL); | |
c801d85f KB |
142 | |
143 | #define IMPLEMENT_CLASS IMPLEMENT_ABSTRACT_CLASS | |
144 | #define IMPLEMENT_CLASS2 IMPLEMENT_ABSTRACT_CLASS2 | |
145 | ||
0c32066b | 146 | #define CLASSINFO(name) (&name::sm_class##name) |
c801d85f | 147 | |
34636400 | 148 | #else // !wxUSE_DYNAMIC_CLASSES |
c801d85f KB |
149 | |
150 | // No dynamic class system: so stub out the macros | |
151 | #define DECLARE_DYNAMIC_CLASS(name) | |
152 | #define DECLARE_ABSTRACT_CLASS(name) | |
153 | #define DECLARE_CLASS(name) | |
154 | #define IMPLEMENT_DYNAMIC_CLASS(name, basename) | |
155 | #define IMPLEMENT_DYNAMIC_CLASS2(name, basename1, basename2) | |
156 | #define IMPLEMENT_ABSTRACT_CLASS(name, basename) | |
157 | #define IMPLEMENT_ABSTRACT_CLASS2(name, basename1, basename2) | |
158 | #define IMPLEMENT_CLASS IMPLEMENT_ABSTRACT_CLASS | |
159 | #define IMPLEMENT_CLASS2 IMPLEMENT_ABSTRACT_CLASS2 | |
160 | ||
34636400 | 161 | #endif // wxUSE_DYNAMIC_CLASSES/!wxUSE_DYNAMIC_CLASSES |
c801d85f | 162 | |
3013b6f4 JS |
163 | #define wxIS_KIND_OF(obj, className) obj->IsKindOf(&className::sm_class##className) |
164 | ||
165 | // Just seems a bit nicer-looking (pretend it's not a macro) | |
166 | #define wxIsKindOf(obj, className) obj->IsKindOf(&className::sm_class##className) | |
c801d85f | 167 | |
34636400 VZ |
168 | // to be replaced by dynamic_cast<> in the future |
169 | #define wxDynamicCast(obj, className) \ | |
170 | ((obj) && ((obj)->IsKindOf(&className::sm_class##className)) \ | |
171 | ? (className *)(obj) \ | |
172 | : (className *)0) | |
173 | ||
f6bcfd97 BP |
174 | #define wxConstCast(obj, className) ((className *)(obj)) |
175 | ||
176 | #ifdef __WXDEBUG__ | |
177 | inline void wxCheckCast(void *ptr) | |
178 | { | |
179 | wxASSERT_MSG( ptr, _T("wxStaticCast() used incorrectly") ); | |
180 | } | |
181 | ||
182 | #define wxStaticCast(obj, className) \ | |
183 | (wxCheckCast(wxDynamicCast(obj, className)), ((className *)(obj))) | |
184 | ||
185 | #else // !Debug | |
186 | #define wxStaticCast(obj, className) ((className *)(obj)) | |
187 | #endif // Debug/!Debug | |
188 | ||
c801d85f KB |
189 | // Unfortunately Borland seems to need this include. |
190 | #ifdef __BORLANDC__ | |
34636400 VZ |
191 | #if wxUSE_IOSTREAMH |
192 | #include <iostream.h> | |
193 | #else | |
194 | #include <iostream> | |
195 | #endif | |
c801d85f KB |
196 | #endif |
197 | ||
198 | class WXDLLEXPORT wxObjectRefData; | |
199 | ||
200 | class WXDLLEXPORT wxObject | |
201 | { | |
202 | public: | |
203 | ||
204 | // This is equivalent to using the macro DECLARE_ABSTRACT_CLASS | |
0c32066b | 205 | static wxClassInfo sm_classwxObject; |
c801d85f KB |
206 | |
207 | wxObject(void); | |
208 | virtual ~wxObject(void); | |
209 | ||
8cb50e4b | 210 | virtual wxClassInfo *GetClassInfo(void) const { return &sm_classwxObject; } |
aadbdf11 GL |
211 | wxObject *Clone(void) const; |
212 | virtual void CopyObject(wxObject& object_dest) const; | |
c801d85f | 213 | |
8cb50e4b | 214 | bool IsKindOf(wxClassInfo *info) const; |
c801d85f | 215 | |
ea57084d | 216 | #if defined(__WXDEBUG__) && wxUSE_MEMORY_TRACING |
4de6207a | 217 | void * operator new (size_t size, wxChar * fileName = NULL, int lineNum = 0); |
4720388f DW |
218 | |
219 | #if defined(__VISAGECPP__) | |
220 | #if __DEBUG_ALLOC__ | |
221 | void operator delete (void * buf,const char * _fname, size_t _line); | |
222 | #endif //__DEBUG_ALLOC__ | |
223 | #else | |
c801d85f | 224 | void operator delete (void * buf); |
4720388f DW |
225 | #endif |
226 | // defined(__VISAGECPP__) | |
27198be4 | 227 | |
76626af2 | 228 | // VC++ 6.0 |
3f4a0c5b | 229 | #if defined(__VISUALC__) && (__VISUALC__ >= 1200) |
f6bcfd97 | 230 | void operator delete(void *buf, wxChar*, int); |
76626af2 JS |
231 | #endif |
232 | ||
3f4a0c5b | 233 | // Causes problems for VC++ |
921b3c17 | 234 | #if wxUSE_ARRAY_MEMORY_OPERATORS && !defined(__VISUALC__) && !defined( __MWERKS__) |
4de6207a | 235 | void * operator new[] (size_t size, wxChar * fileName = NULL, int lineNum = 0); |
c801d85f KB |
236 | void operator delete[] (void * buf); |
237 | #endif | |
238 | ||
27198be4 | 239 | #ifdef __MWERKS__ |
7c74e7fe SC |
240 | void * operator new[] (size_t size, wxChar * fileName , int lineNum = 0); |
241 | void * operator new[] (size_t size) { return operator new[] ( size , NULL , 0 ) ; } | |
27198be4 SC |
242 | void operator delete[] (void * buf); |
243 | #endif | |
244 | ||
3f4a0c5b | 245 | #endif // Debug & memory tracing |
c801d85f | 246 | |
38830220 | 247 | #if wxUSE_STD_IOSTREAM && (defined(__WXDEBUG__) || wxUSE_DEBUG_CONTEXT) |
c801d85f KB |
248 | virtual void Dump(ostream& str); |
249 | #endif | |
250 | ||
9838df2c | 251 | #if wxUSE_SERIAL |
7a4b9130 GL |
252 | virtual void StoreObject( wxObjectOutputStream &stream ); |
253 | virtual void LoadObject( wxObjectInputStream &stream ); | |
c801d85f KB |
254 | #endif |
255 | ||
256 | // make a 'clone' of the object | |
257 | void Ref(const wxObject& clone); | |
258 | ||
259 | // destroy a reference | |
260 | void UnRef(void); | |
261 | ||
262 | inline wxObjectRefData *GetRefData(void) const { return m_refData; } | |
263 | inline void SetRefData(wxObjectRefData *data) { m_refData = data; } | |
264 | ||
4720388f DW |
265 | //EK |
266 | #if defined(__WXDEBUG__) && defined(__VISAGECPP__) | |
267 | public: | |
268 | static int N; | |
269 | static int Nid; // total number of objects and serial counter | |
270 | int id; // serial number for current object | |
271 | #endif // __WXDEBUG__ | |
272 | ||
c801d85f | 273 | protected: |
0c32066b | 274 | wxObjectRefData* m_refData; |
9838df2c | 275 | #if wxUSE_SERIAL |
0c32066b | 276 | wxObject_Serialize* m_serialObj; |
f4a8c29f | 277 | #endif |
c801d85f KB |
278 | }; |
279 | ||
280 | /* | |
281 | * wxObjectData | |
282 | */ | |
283 | ||
284 | class WXDLLEXPORT wxObjectRefData { | |
285 | ||
286 | friend class wxObject; | |
287 | ||
288 | public: | |
289 | wxObjectRefData(void); | |
290 | virtual ~wxObjectRefData(void); | |
291 | ||
292 | inline int GetRefCount(void) const { return m_count; } | |
293 | private: | |
294 | int m_count; | |
295 | }; | |
296 | ||
7fe7d506 JS |
297 | #ifdef __WXDEBUG__ |
298 | #ifndef WXDEBUG_NEW | |
4de6207a | 299 | #define WXDEBUG_NEW new(__TFILE__,__LINE__) |
7fe7d506 JS |
300 | #endif |
301 | #else | |
302 | #define WXDEBUG_NEW new | |
303 | #endif | |
304 | ||
305 | // Redefine new to be the debugging version. This doesn't | |
306 | // work with all compilers, in which case you need to | |
307 | // use WXDEBUG_NEW explicitly if you wish to use the debugging version. | |
308 | ||
309 | #if defined(__WXDEBUG__) && wxUSE_GLOBAL_MEMORY_OPERATORS && wxUSE_DEBUG_NEW_ALWAYS | |
4de6207a | 310 | #define new new(__TFILE__,__LINE__) |
c801d85f KB |
311 | #endif |
312 | ||
313 | #endif | |
34138703 | 314 | // _WX_OBJECTH__ |
c801d85f KB |
315 | |
316 |