]>
Commit | Line | Data |
---|---|---|
1 | ///////////////////////////////////////////////////////////////////////////// | |
2 | // Name: wx/object.h | |
3 | // Purpose: wxObject class, plus run-time type information macros | |
4 | // Author: Julian Smart | |
5 | // Modified by: Ron Lee | |
6 | // Created: 01/02/97 | |
7 | // RCS-ID: $Id$ | |
8 | // Copyright: (c) 1997 Julian Smart | |
9 | // (c) 2001 Ron Lee <ron@debian.org> | |
10 | // Licence: wxWindows licence | |
11 | ///////////////////////////////////////////////////////////////////////////// | |
12 | ||
13 | #ifndef _WX_OBJECTH__ | |
14 | #define _WX_OBJECTH__ | |
15 | ||
16 | // ---------------------------------------------------------------------------- | |
17 | // headers | |
18 | // ---------------------------------------------------------------------------- | |
19 | ||
20 | #include "wx/memory.h" | |
21 | ||
22 | class WXDLLIMPEXP_FWD_BASE wxObject; | |
23 | class WXDLLIMPEXP_FWD_BASE wxString; | |
24 | ||
25 | #ifndef wxUSE_EXTENDED_RTTI | |
26 | #define wxUSE_EXTENDED_RTTI 0 | |
27 | #endif | |
28 | ||
29 | #define DECLARE_CLASS_INFO_ITERATORS() \ | |
30 | class WXDLLIMPEXP_BASE const_iterator \ | |
31 | { \ | |
32 | typedef wxHashTable_Node Node; \ | |
33 | public: \ | |
34 | typedef const wxClassInfo* value_type; \ | |
35 | typedef const value_type& const_reference; \ | |
36 | typedef const_iterator itor; \ | |
37 | typedef value_type* ptr_type; \ | |
38 | \ | |
39 | Node* m_node; \ | |
40 | wxHashTable* m_table; \ | |
41 | public: \ | |
42 | typedef const_reference reference_type; \ | |
43 | typedef ptr_type pointer_type; \ | |
44 | \ | |
45 | const_iterator(Node* node, wxHashTable* table) \ | |
46 | : m_node(node), m_table(table) { } \ | |
47 | const_iterator() : m_node(NULL), m_table(NULL) { } \ | |
48 | value_type operator*() const; \ | |
49 | itor& operator++(); \ | |
50 | const itor operator++(int); \ | |
51 | bool operator!=(const itor& it) const \ | |
52 | { return it.m_node != m_node; } \ | |
53 | bool operator==(const itor& it) const \ | |
54 | { return it.m_node == m_node; } \ | |
55 | }; \ | |
56 | \ | |
57 | static const_iterator begin_classinfo(); \ | |
58 | static const_iterator end_classinfo(); | |
59 | ||
60 | #if wxUSE_EXTENDED_RTTI | |
61 | #include "wx/xti.h" | |
62 | #else | |
63 | ||
64 | // ---------------------------------------------------------------------------- | |
65 | // conditional compilation | |
66 | // ---------------------------------------------------------------------------- | |
67 | ||
68 | class WXDLLIMPEXP_FWD_BASE wxClassInfo; | |
69 | class WXDLLIMPEXP_FWD_BASE wxHashTable; | |
70 | class WXDLLIMPEXP_FWD_BASE wxObject; | |
71 | class WXDLLIMPEXP_FWD_BASE wxPluginLibrary; | |
72 | class WXDLLIMPEXP_FWD_BASE wxObjectRefData; | |
73 | class WXDLLIMPEXP_FWD_BASE wxHashTable_Node; | |
74 | ||
75 | // ---------------------------------------------------------------------------- | |
76 | // wxClassInfo | |
77 | // ---------------------------------------------------------------------------- | |
78 | ||
79 | typedef wxObject *(*wxObjectConstructorFn)(void); | |
80 | ||
81 | class WXDLLIMPEXP_BASE wxClassInfo | |
82 | { | |
83 | friend class WXDLLIMPEXP_FWD_BASE wxObject; | |
84 | friend WXDLLIMPEXP_BASE wxObject *wxCreateDynamicObject(const wxString& name); | |
85 | public: | |
86 | wxClassInfo( const wxChar *className, | |
87 | const wxClassInfo *baseInfo1, | |
88 | const wxClassInfo *baseInfo2, | |
89 | int size, | |
90 | wxObjectConstructorFn ctor ) | |
91 | : m_className(className) | |
92 | , m_objectSize(size) | |
93 | , m_objectConstructor(ctor) | |
94 | , m_baseInfo1(baseInfo1) | |
95 | , m_baseInfo2(baseInfo2) | |
96 | , m_next(sm_first) | |
97 | { | |
98 | sm_first = this; | |
99 | Register(); | |
100 | } | |
101 | ||
102 | ~wxClassInfo(); | |
103 | ||
104 | wxObject *CreateObject() const | |
105 | { return m_objectConstructor ? (*m_objectConstructor)() : 0; } | |
106 | bool IsDynamic() const { return (NULL != m_objectConstructor); } | |
107 | ||
108 | const wxChar *GetClassName() const { return m_className; } | |
109 | const wxChar *GetBaseClassName1() const | |
110 | { return m_baseInfo1 ? m_baseInfo1->GetClassName() : NULL; } | |
111 | const wxChar *GetBaseClassName2() const | |
112 | { return m_baseInfo2 ? m_baseInfo2->GetClassName() : NULL; } | |
113 | const wxClassInfo *GetBaseClass1() const { return m_baseInfo1; } | |
114 | const wxClassInfo *GetBaseClass2() const { return m_baseInfo2; } | |
115 | int GetSize() const { return m_objectSize; } | |
116 | ||
117 | wxObjectConstructorFn GetConstructor() const | |
118 | { return m_objectConstructor; } | |
119 | static const wxClassInfo *GetFirst() { return sm_first; } | |
120 | const wxClassInfo *GetNext() const { return m_next; } | |
121 | static wxClassInfo *FindClass(const wxString& className); | |
122 | ||
123 | // Climb upwards through inheritance hierarchy. | |
124 | // Dual inheritance is catered for. | |
125 | ||
126 | bool IsKindOf(const wxClassInfo *info) const | |
127 | { | |
128 | return info != 0 && | |
129 | ( info == this || | |
130 | ( m_baseInfo1 && m_baseInfo1->IsKindOf(info) ) || | |
131 | ( m_baseInfo2 && m_baseInfo2->IsKindOf(info) ) ); | |
132 | } | |
133 | ||
134 | DECLARE_CLASS_INFO_ITERATORS() | |
135 | private: | |
136 | const wxChar *m_className; | |
137 | int m_objectSize; | |
138 | wxObjectConstructorFn m_objectConstructor; | |
139 | ||
140 | // Pointers to base wxClassInfos | |
141 | ||
142 | const wxClassInfo *m_baseInfo1; | |
143 | const wxClassInfo *m_baseInfo2; | |
144 | ||
145 | // class info object live in a linked list: | |
146 | // pointers to its head and the next element in it | |
147 | ||
148 | static wxClassInfo *sm_first; | |
149 | wxClassInfo *m_next; | |
150 | ||
151 | static wxHashTable *sm_classTable; | |
152 | ||
153 | protected: | |
154 | // registers the class | |
155 | void Register(); | |
156 | void Unregister(); | |
157 | ||
158 | DECLARE_NO_COPY_CLASS(wxClassInfo) | |
159 | }; | |
160 | ||
161 | WXDLLIMPEXP_BASE wxObject *wxCreateDynamicObject(const wxString& name); | |
162 | ||
163 | // ---------------------------------------------------------------------------- | |
164 | // Dynamic class macros | |
165 | // ---------------------------------------------------------------------------- | |
166 | ||
167 | #define DECLARE_ABSTRACT_CLASS(name) \ | |
168 | public: \ | |
169 | static wxClassInfo ms_classInfo; \ | |
170 | virtual wxClassInfo *GetClassInfo() const; | |
171 | ||
172 | #define DECLARE_DYNAMIC_CLASS_NO_ASSIGN(name) \ | |
173 | DECLARE_NO_ASSIGN_CLASS(name) \ | |
174 | DECLARE_DYNAMIC_CLASS(name) | |
175 | ||
176 | #define DECLARE_DYNAMIC_CLASS_NO_COPY(name) \ | |
177 | DECLARE_NO_COPY_CLASS(name) \ | |
178 | DECLARE_DYNAMIC_CLASS(name) | |
179 | ||
180 | #define DECLARE_DYNAMIC_CLASS(name) \ | |
181 | DECLARE_ABSTRACT_CLASS(name) \ | |
182 | static wxObject* wxCreateObject(); | |
183 | ||
184 | #define DECLARE_CLASS(name) DECLARE_DYNAMIC_CLASS(name) | |
185 | ||
186 | ||
187 | // common part of the macros below | |
188 | #define wxIMPLEMENT_CLASS_COMMON(name, basename, baseclsinfo2, func) \ | |
189 | wxClassInfo name::ms_classInfo(wxT(#name), \ | |
190 | &basename::ms_classInfo, \ | |
191 | baseclsinfo2, \ | |
192 | (int) sizeof(name), \ | |
193 | (wxObjectConstructorFn) func); \ | |
194 | \ | |
195 | wxClassInfo *name::GetClassInfo() const \ | |
196 | { return &name::ms_classInfo; } | |
197 | ||
198 | #define wxIMPLEMENT_CLASS_COMMON1(name, basename, func) \ | |
199 | wxIMPLEMENT_CLASS_COMMON(name, basename, NULL, func) | |
200 | ||
201 | #define wxIMPLEMENT_CLASS_COMMON2(name, basename1, basename2, func) \ | |
202 | wxIMPLEMENT_CLASS_COMMON(name, basename1, &basename2::ms_classInfo, func) | |
203 | ||
204 | // ----------------------------------- | |
205 | // for concrete classes | |
206 | // ----------------------------------- | |
207 | ||
208 | // Single inheritance with one base class | |
209 | #define IMPLEMENT_DYNAMIC_CLASS(name, basename) \ | |
210 | wxIMPLEMENT_CLASS_COMMON1(name, basename, name::wxCreateObject) \ | |
211 | wxObject* name::wxCreateObject() \ | |
212 | { return new name; } | |
213 | ||
214 | // Multiple inheritance with two base classes | |
215 | #define IMPLEMENT_DYNAMIC_CLASS2(name, basename1, basename2) \ | |
216 | wxIMPLEMENT_CLASS_COMMON2(name, basename1, basename2, \ | |
217 | name::wxCreateObject) \ | |
218 | wxObject* name::wxCreateObject() \ | |
219 | { return new name; } | |
220 | ||
221 | // ----------------------------------- | |
222 | // for abstract classes | |
223 | // ----------------------------------- | |
224 | ||
225 | // Single inheritance with one base class | |
226 | ||
227 | #define IMPLEMENT_ABSTRACT_CLASS(name, basename) \ | |
228 | wxIMPLEMENT_CLASS_COMMON1(name, basename, NULL) | |
229 | ||
230 | // Multiple inheritance with two base classes | |
231 | ||
232 | #define IMPLEMENT_ABSTRACT_CLASS2(name, basename1, basename2) \ | |
233 | wxIMPLEMENT_CLASS_COMMON2(name, basename1, basename2, NULL) | |
234 | ||
235 | #define IMPLEMENT_CLASS IMPLEMENT_ABSTRACT_CLASS | |
236 | #define IMPLEMENT_CLASS2 IMPLEMENT_ABSTRACT_CLASS2 | |
237 | ||
238 | #endif // !wxUSE_EXTENDED_RTTI | |
239 | ||
240 | ||
241 | // ----------------------------------- | |
242 | // for pluggable classes | |
243 | // ----------------------------------- | |
244 | ||
245 | // NOTE: this should probably be the very first statement | |
246 | // in the class declaration so wxPluginSentinel is | |
247 | // the first member initialised and the last destroyed. | |
248 | ||
249 | // _DECLARE_DL_SENTINEL(name) wxPluginSentinel m_pluginsentinel; | |
250 | ||
251 | #if wxUSE_NESTED_CLASSES | |
252 | ||
253 | #define _DECLARE_DL_SENTINEL(name, exportdecl) \ | |
254 | class exportdecl name##PluginSentinel { \ | |
255 | private: \ | |
256 | static const wxString sm_className; \ | |
257 | public: \ | |
258 | name##PluginSentinel(); \ | |
259 | ~name##PluginSentinel(); \ | |
260 | }; \ | |
261 | name##PluginSentinel m_pluginsentinel; | |
262 | ||
263 | #define _IMPLEMENT_DL_SENTINEL(name) \ | |
264 | const wxString name::name##PluginSentinel::sm_className(#name); \ | |
265 | name::name##PluginSentinel::name##PluginSentinel() { \ | |
266 | wxPluginLibrary *e = (wxPluginLibrary*) wxPluginLibrary::ms_classes.Get(#name); \ | |
267 | if( e != 0 ) { e->RefObj(); } \ | |
268 | } \ | |
269 | name::name##PluginSentinel::~name##PluginSentinel() { \ | |
270 | wxPluginLibrary *e = (wxPluginLibrary*) wxPluginLibrary::ms_classes.Get(#name); \ | |
271 | if( e != 0 ) { e->UnrefObj(); } \ | |
272 | } | |
273 | #else | |
274 | ||
275 | #define _DECLARE_DL_SENTINEL(name) | |
276 | #define _IMPLEMENT_DL_SENTINEL(name) | |
277 | ||
278 | #endif // wxUSE_NESTED_CLASSES | |
279 | ||
280 | #define DECLARE_PLUGGABLE_CLASS(name) \ | |
281 | DECLARE_DYNAMIC_CLASS(name) _DECLARE_DL_SENTINEL(name, WXDLLEXPORT) | |
282 | #define DECLARE_ABSTRACT_PLUGGABLE_CLASS(name) \ | |
283 | DECLARE_ABSTRACT_CLASS(name) _DECLARE_DL_SENTINEL(name, WXDLLEXPORT) | |
284 | ||
285 | #define DECLARE_USER_EXPORTED_PLUGGABLE_CLASS(name, usergoo) \ | |
286 | DECLARE_DYNAMIC_CLASS(name) _DECLARE_DL_SENTINEL(name, usergoo) | |
287 | #define DECLARE_USER_EXPORTED_ABSTRACT_PLUGGABLE_CLASS(name, usergoo) \ | |
288 | DECLARE_ABSTRACT_CLASS(name) _DECLARE_DL_SENTINEL(name, usergoo) | |
289 | ||
290 | #define IMPLEMENT_PLUGGABLE_CLASS(name, basename) \ | |
291 | IMPLEMENT_DYNAMIC_CLASS(name, basename) _IMPLEMENT_DL_SENTINEL(name) | |
292 | #define IMPLEMENT_PLUGGABLE_CLASS2(name, basename1, basename2) \ | |
293 | IMPLEMENT_DYNAMIC_CLASS2(name, basename1, basename2) _IMPLEMENT_DL_SENTINEL(name) | |
294 | #define IMPLEMENT_ABSTRACT_PLUGGABLE_CLASS(name, basename) \ | |
295 | IMPLEMENT_ABSTRACT_CLASS(name, basename) _IMPLEMENT_DL_SENTINEL(name) | |
296 | #define IMPLEMENT_ABSTRACT_PLUGGABLE_CLASS2(name, basename1, basename2) \ | |
297 | IMPLEMENT_ABSTRACT_CLASS2(name, basename1, basename2) _IMPLEMENT_DL_SENTINEL(name) | |
298 | ||
299 | #define IMPLEMENT_USER_EXPORTED_PLUGGABLE_CLASS(name, basename) \ | |
300 | IMPLEMENT_PLUGGABLE_CLASS(name, basename) | |
301 | #define IMPLEMENT_USER_EXPORTED_PLUGGABLE_CLASS2(name, basename1, basename2) \ | |
302 | IMPLEMENT_PLUGGABLE_CLASS2(name, basename1, basename2) | |
303 | #define IMPLEMENT_USER_EXPORTED_ABSTRACT_PLUGGABLE_CLASS(name, basename) \ | |
304 | IMPLEMENT_ABSTRACT_PLUGGABLE_CLASS(name, basename) | |
305 | #define IMPLEMENT_USER_EXPORTED_ABSTRACT_PLUGGABLE_CLASS2(name, basename1, basename2) \ | |
306 | IMPLEMENT_ABSTRACT_PLUGGABLE_CLASS2(name, basename1, basename2) | |
307 | ||
308 | #define CLASSINFO(name) (&name::ms_classInfo) | |
309 | ||
310 | #define wxIS_KIND_OF(obj, className) obj->IsKindOf(&className::ms_classInfo) | |
311 | ||
312 | // Just seems a bit nicer-looking (pretend it's not a macro) | |
313 | #define wxIsKindOf(obj, className) obj->IsKindOf(&className::ms_classInfo) | |
314 | ||
315 | // this cast does some more checks at compile time as it uses static_cast | |
316 | // internally | |
317 | // | |
318 | // note that it still has different semantics from dynamic_cast<> and so can't | |
319 | // be replaced by it as long as there are any compilers not supporting it | |
320 | #define wxDynamicCast(obj, className) \ | |
321 | ((className *) wxCheckDynamicCast( \ | |
322 | wx_const_cast(wxObject *, wx_static_cast(const wxObject *, \ | |
323 | wx_const_cast(className *, wx_static_cast(const className *, obj)))), \ | |
324 | &className::ms_classInfo)) | |
325 | ||
326 | // The 'this' pointer is always true, so use this version | |
327 | // to cast the this pointer and avoid compiler warnings. | |
328 | #define wxDynamicCastThis(className) \ | |
329 | (IsKindOf(&className::ms_classInfo) ? (className *)(this) : (className *)0) | |
330 | ||
331 | #ifdef __WXDEBUG__ | |
332 | inline void* wxCheckCast(void *ptr) | |
333 | { | |
334 | wxASSERT_MSG( ptr, _T("wxStaticCast() used incorrectly") ); | |
335 | return ptr; | |
336 | } | |
337 | #define wxStaticCast(obj, className) \ | |
338 | ((className *)wxCheckCast(wxDynamicCast(obj, className))) | |
339 | ||
340 | #else // !__WXDEBUG__ | |
341 | #define wxStaticCast(obj, className) \ | |
342 | wx_const_cast(className *, wx_static_cast(const className *, obj)) | |
343 | ||
344 | #endif // __WXDEBUG__ | |
345 | ||
346 | // ---------------------------------------------------------------------------- | |
347 | // set up memory debugging macros | |
348 | // ---------------------------------------------------------------------------- | |
349 | ||
350 | /* | |
351 | Which new/delete operator variants do we want? | |
352 | ||
353 | _WX_WANT_NEW_SIZET_WXCHAR_INT = void *operator new (size_t size, wxChar *fileName = 0, int lineNum = 0) | |
354 | _WX_WANT_DELETE_VOID = void operator delete (void * buf) | |
355 | _WX_WANT_DELETE_VOID_CONSTCHAR_SIZET = void operator delete (void *buf, const char *_fname, size_t _line) | |
356 | _WX_WANT_DELETE_VOID_WXCHAR_INT = void operator delete(void *buf, wxChar*, int) | |
357 | _WX_WANT_ARRAY_NEW_SIZET_WXCHAR_INT = void *operator new[] (size_t size, wxChar *fileName , int lineNum = 0) | |
358 | _WX_WANT_ARRAY_DELETE_VOID = void operator delete[] (void *buf) | |
359 | _WX_WANT_ARRAY_DELETE_VOID_WXCHAR_INT = void operator delete[] (void* buf, wxChar*, int ) | |
360 | */ | |
361 | ||
362 | #if defined(__WXDEBUG__) && wxUSE_MEMORY_TRACING | |
363 | ||
364 | // All compilers get this one | |
365 | #define _WX_WANT_NEW_SIZET_WXCHAR_INT | |
366 | ||
367 | // Everyone except Visage gets the next one | |
368 | #ifndef __VISAGECPP__ | |
369 | #define _WX_WANT_DELETE_VOID | |
370 | #endif | |
371 | ||
372 | // Only visage gets this one under the correct circumstances | |
373 | #if defined(__VISAGECPP__) && __DEBUG_ALLOC__ | |
374 | #define _WX_WANT_DELETE_VOID_CONSTCHAR_SIZET | |
375 | #endif | |
376 | ||
377 | // Only VC++ 6 and CodeWarrior get overloaded delete that matches new | |
378 | #if (defined(__VISUALC__) && (__VISUALC__ >= 1200)) || \ | |
379 | (defined(__MWERKS__) && (__MWERKS__ >= 0x2400)) | |
380 | #define _WX_WANT_DELETE_VOID_WXCHAR_INT | |
381 | #endif | |
382 | ||
383 | // Now see who (if anyone) gets the array memory operators | |
384 | #if wxUSE_ARRAY_MEMORY_OPERATORS | |
385 | ||
386 | // Everyone except Visual C++ (cause problems for VC++ - crashes) | |
387 | #if !defined(__VISUALC__) | |
388 | #define _WX_WANT_ARRAY_NEW_SIZET_WXCHAR_INT | |
389 | #endif | |
390 | ||
391 | // Everyone except Visual C++ (cause problems for VC++ - crashes) | |
392 | #if !defined(__VISUALC__) | |
393 | #define _WX_WANT_ARRAY_DELETE_VOID | |
394 | #endif | |
395 | ||
396 | // Only CodeWarrior 6 or higher | |
397 | #if defined(__MWERKS__) && (__MWERKS__ >= 0x2400) | |
398 | #define _WX_WANT_ARRAY_DELETE_VOID_WXCHAR_INT | |
399 | #endif | |
400 | ||
401 | #endif // wxUSE_ARRAY_MEMORY_OPERATORS | |
402 | ||
403 | #endif // __WXDEBUG__ && wxUSE_MEMORY_TRACING | |
404 | ||
405 | // ---------------------------------------------------------------------------- | |
406 | // wxObjectRefData: ref counted data meant to be stored in wxObject | |
407 | // ---------------------------------------------------------------------------- | |
408 | ||
409 | class WXDLLIMPEXP_BASE wxObjectRefData | |
410 | { | |
411 | friend class WXDLLIMPEXP_FWD_BASE wxObject; | |
412 | ||
413 | public: | |
414 | wxObjectRefData() : m_count(1) { } | |
415 | ||
416 | int GetRefCount() const { return m_count; } | |
417 | ||
418 | void IncRef() { m_count++; } | |
419 | void DecRef(); | |
420 | ||
421 | protected: | |
422 | // this object should never be destroyed directly but only as a | |
423 | // result of a DecRef() call: | |
424 | virtual ~wxObjectRefData() { } | |
425 | ||
426 | private: | |
427 | // our refcount: | |
428 | int m_count; | |
429 | }; | |
430 | ||
431 | // ---------------------------------------------------------------------------- | |
432 | // wxObjectDataPtr: helper class to avoid memleaks because of missing calls | |
433 | // to wxObjectRefData::DecRef | |
434 | // ---------------------------------------------------------------------------- | |
435 | ||
436 | template <class T> | |
437 | class wxObjectDataPtr | |
438 | { | |
439 | public: | |
440 | typedef T element_type; | |
441 | ||
442 | wxEXPLICIT wxObjectDataPtr(T *ptr = NULL) : m_ptr(ptr) {} | |
443 | ||
444 | // copy ctor | |
445 | wxObjectDataPtr(const wxObjectDataPtr<T> &tocopy) | |
446 | : m_ptr(tocopy.m_ptr) | |
447 | { | |
448 | if (m_ptr) | |
449 | m_ptr->IncRef(); | |
450 | } | |
451 | ||
452 | ~wxObjectDataPtr() | |
453 | { | |
454 | if (m_ptr) | |
455 | m_ptr->DecRef(); | |
456 | } | |
457 | ||
458 | T *get() const { return m_ptr; } | |
459 | T *operator->() const { return get(); } | |
460 | ||
461 | void reset(T *ptr) | |
462 | { | |
463 | if (m_ptr) | |
464 | m_ptr->DecRef(); | |
465 | m_ptr = ptr; | |
466 | } | |
467 | ||
468 | wxObjectDataPtr& operator=(const wxObjectDataPtr &tocopy) | |
469 | { | |
470 | if (m_ptr) | |
471 | m_ptr->DecRef(); | |
472 | m_ptr = tocopy.m_ptr; | |
473 | if (m_ptr) | |
474 | m_ptr->IncRef(); | |
475 | return *this; | |
476 | } | |
477 | ||
478 | wxObjectDataPtr& operator=(T *ptr) | |
479 | { | |
480 | if (m_ptr) | |
481 | m_ptr->DecRef(); | |
482 | m_ptr = ptr; | |
483 | if (m_ptr) | |
484 | m_ptr->IncRef(); | |
485 | return *this; | |
486 | } | |
487 | ||
488 | private: | |
489 | T *m_ptr; | |
490 | }; | |
491 | ||
492 | // ---------------------------------------------------------------------------- | |
493 | // wxObject: the root class of wxWidgets object hierarchy | |
494 | // ---------------------------------------------------------------------------- | |
495 | ||
496 | class WXDLLIMPEXP_BASE wxObject | |
497 | { | |
498 | DECLARE_ABSTRACT_CLASS(wxObject) | |
499 | ||
500 | public: | |
501 | wxObject() { m_refData = NULL; } | |
502 | virtual ~wxObject() { UnRef(); } | |
503 | ||
504 | wxObject(const wxObject& other) | |
505 | { | |
506 | m_refData = other.m_refData; | |
507 | if (m_refData) | |
508 | m_refData->m_count++; | |
509 | } | |
510 | ||
511 | wxObject& operator=(const wxObject& other) | |
512 | { | |
513 | if ( this != &other ) | |
514 | { | |
515 | Ref(other); | |
516 | } | |
517 | return *this; | |
518 | } | |
519 | ||
520 | bool IsKindOf(wxClassInfo *info) const; | |
521 | ||
522 | ||
523 | // Turn on the correct set of new and delete operators | |
524 | ||
525 | #ifdef _WX_WANT_NEW_SIZET_WXCHAR_INT | |
526 | void *operator new ( size_t size, const wxChar *fileName = NULL, int lineNum = 0 ); | |
527 | #endif | |
528 | ||
529 | #ifdef _WX_WANT_DELETE_VOID | |
530 | void operator delete ( void * buf ); | |
531 | #endif | |
532 | ||
533 | #ifdef _WX_WANT_DELETE_VOID_CONSTCHAR_SIZET | |
534 | void operator delete ( void *buf, const char *_fname, size_t _line ); | |
535 | #endif | |
536 | ||
537 | #ifdef _WX_WANT_DELETE_VOID_WXCHAR_INT | |
538 | void operator delete ( void *buf, const wxChar*, int ); | |
539 | #endif | |
540 | ||
541 | #ifdef _WX_WANT_ARRAY_NEW_SIZET_WXCHAR_INT | |
542 | void *operator new[] ( size_t size, const wxChar *fileName = NULL, int lineNum = 0 ); | |
543 | #endif | |
544 | ||
545 | #ifdef _WX_WANT_ARRAY_DELETE_VOID | |
546 | void operator delete[] ( void *buf ); | |
547 | #endif | |
548 | ||
549 | #ifdef _WX_WANT_ARRAY_DELETE_VOID_WXCHAR_INT | |
550 | void operator delete[] (void* buf, const wxChar*, int ); | |
551 | #endif | |
552 | ||
553 | // ref counted data handling methods | |
554 | ||
555 | // get/set | |
556 | wxObjectRefData *GetRefData() const { return m_refData; } | |
557 | void SetRefData(wxObjectRefData *data) { m_refData = data; } | |
558 | ||
559 | // make a 'clone' of the object | |
560 | void Ref(const wxObject& clone); | |
561 | ||
562 | // destroy a reference | |
563 | void UnRef(); | |
564 | ||
565 | // Make sure this object has only one reference | |
566 | void UnShare() { AllocExclusive(); } | |
567 | ||
568 | // check if this object references the same data as the other one | |
569 | bool IsSameAs(const wxObject& o) const { return m_refData == o.m_refData; } | |
570 | ||
571 | protected: | |
572 | // ensure that our data is not shared with anybody else: if we have no | |
573 | // data, it is created using CreateRefData() below, if we have shared data | |
574 | // it is copied using CloneRefData(), otherwise nothing is done | |
575 | void AllocExclusive(); | |
576 | ||
577 | // both methods must be implemented if AllocExclusive() is used, not pure | |
578 | // virtual only because of the backwards compatibility reasons | |
579 | ||
580 | // create a new m_refData | |
581 | virtual wxObjectRefData *CreateRefData() const; | |
582 | ||
583 | // create a new m_refData initialized with the given one | |
584 | virtual wxObjectRefData *CloneRefData(const wxObjectRefData *data) const; | |
585 | ||
586 | wxObjectRefData *m_refData; | |
587 | }; | |
588 | ||
589 | inline wxObject *wxCheckDynamicCast(wxObject *obj, wxClassInfo *classInfo) | |
590 | { | |
591 | return obj && obj->GetClassInfo()->IsKindOf(classInfo) ? obj : NULL; | |
592 | } | |
593 | ||
594 | #if wxUSE_EXTENDED_RTTI | |
595 | class WXDLLIMPEXP_BASE wxDynamicObject : public wxObject | |
596 | { | |
597 | friend class WXDLLIMPEXP_FWD_BASE wxDynamicClassInfo ; | |
598 | public: | |
599 | // instantiates this object with an instance of its superclass | |
600 | wxDynamicObject(wxObject* superClassInstance, const wxDynamicClassInfo *info) ; | |
601 | virtual ~wxDynamicObject(); | |
602 | ||
603 | void SetProperty (const wxChar *propertyName, const wxxVariant &value); | |
604 | wxxVariant GetProperty (const wxChar *propertyName) const ; | |
605 | ||
606 | // get the runtime identity of this object | |
607 | wxClassInfo *GetClassInfo() const | |
608 | { | |
609 | #ifdef _MSC_VER | |
610 | return (wxClassInfo*) m_classInfo; | |
611 | #else | |
612 | wxDynamicClassInfo *nonconst = wx_const_cast(wxDynamicClassInfo *, m_classInfo); | |
613 | return wx_static_cast(wxClassInfo *, nonconst); | |
614 | #endif | |
615 | } | |
616 | ||
617 | wxObject* GetSuperClassInstance() const | |
618 | { | |
619 | return m_superClassInstance ; | |
620 | } | |
621 | private : | |
622 | // removes an existing runtime-property | |
623 | void RemoveProperty( const wxChar *propertyName ) ; | |
624 | ||
625 | // renames an existing runtime-property | |
626 | void RenameProperty( const wxChar *oldPropertyName , const wxChar *newPropertyName ) ; | |
627 | ||
628 | wxObject *m_superClassInstance ; | |
629 | const wxDynamicClassInfo *m_classInfo; | |
630 | struct wxDynamicObjectInternal; | |
631 | wxDynamicObjectInternal *m_data; | |
632 | }; | |
633 | #endif | |
634 | ||
635 | // ---------------------------------------------------------------------------- | |
636 | // more debugging macros | |
637 | // ---------------------------------------------------------------------------- | |
638 | ||
639 | // Redefine new to be the debugging version. This doesn't work with all | |
640 | // compilers, in which case you need to use WXDEBUG_NEW explicitly if you wish | |
641 | // to use the debugging version. | |
642 | ||
643 | #ifdef __WXDEBUG__ | |
644 | #define WXDEBUG_NEW new(__TFILE__,__LINE__) | |
645 | ||
646 | #if wxUSE_DEBUG_NEW_ALWAYS | |
647 | #if wxUSE_GLOBAL_MEMORY_OPERATORS | |
648 | #define new WXDEBUG_NEW | |
649 | #elif defined(__VISUALC__) | |
650 | // Including this file redefines new and allows leak reports to | |
651 | // contain line numbers | |
652 | #include "wx/msw/msvcrt.h" | |
653 | #endif | |
654 | #endif // wxUSE_DEBUG_NEW_ALWAYS | |
655 | #else // !__WXDEBUG__ | |
656 | #define WXDEBUG_NEW new | |
657 | #endif // __WXDEBUG__/!__WXDEBUG__ | |
658 | ||
659 | #endif // _WX_OBJECTH__ |