]> git.saurik.com Git - wxWidgets.git/blame - include/wx/object.h
setup.h for makefile builds
[wxWidgets.git] / include / wx / object.h
CommitLineData
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
22class 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
35class WXDLLEXPORT wxClassInfo;
1678ad78 36class WXDLLEXPORT wxInputStream;
858f7d66 37class WXDLLEXPORT wxOutputStream;
f4a8c29f
GL
38class WXDLLEXPORT wxObjectInputStream;
39class WXDLLEXPORT wxObjectOutputStream;
40class WXDLLEXPORT wxHashTable;
41class WXDLLEXPORT wxObject_Serialize;
c801d85f 42
fbc535ff 43#if wxUSE_IOSTREAMH
3f4a0c5b
VZ
44 // N.B. BC++ doesn't have istream.h, ostream.h
45# include <iostream.h>
fbc535ff 46#else
3f4a0c5b
VZ
47# include <ostream>
48# if defined(__VISUALC__) || defined(__MWERKS__)
49 using namespace std;
50# endif
fbc535ff
JS
51#endif
52
c801d85f
KB
53/*
54 * Dynamic object system declarations
55 */
56
57typedef wxObject * (*wxObjectConstructorFn) (void);
58
c801d85f
KB
59class WXDLLEXPORT wxClassInfo
60{
61 public:
c801d85f 62 wxClassInfo(char *cName, char *baseName1, char *baseName2, int sz, wxObjectConstructorFn fn);
c801d85f
KB
63
64 wxObject *CreateObject(void);
3f4a0c5b 65
0c32066b
JS
66 inline char *GetClassName(void) const { return m_className; }
67 inline char *GetBaseClassName1(void) const { return m_baseClassName1; }
68 inline char *GetBaseClassName2(void) const { return m_baseClassName2; }
69 inline wxClassInfo* GetBaseClass1() const { return m_baseInfo1; }
70 inline wxClassInfo* GetBaseClass2() const { return m_baseInfo2; }
71 inline int GetSize(void) const { return m_objectSize; }
72 inline wxObjectConstructorFn GetConstructor() const { return m_objectConstructor; }
856d2e52 73 static inline wxClassInfo* GetFirst() { return sm_first; }
0c32066b 74 inline wxClassInfo* GetNext() const { return m_next; }
8cb50e4b 75 bool IsKindOf(wxClassInfo *info) const;
c801d85f
KB
76
77 static wxClassInfo *FindClass(char *c);
0c32066b
JS
78
79 // Initializes parent pointers and hash table for fast searching.
c801d85f 80 static void InitializeClasses(void);
0c32066b
JS
81
82 // Cleans up hash table used for fast searching.
83 static void CleanUpClasses(void);
84
85public:
86 char* m_className;
87 char* m_baseClassName1;
88 char* m_baseClassName2;
89 int m_objectSize;
90 wxObjectConstructorFn m_objectConstructor;
3f4a0c5b 91
0c32066b
JS
92 // Pointers to base wxClassInfos: set in InitializeClasses
93 // called from wx_main.cc
94 wxClassInfo* m_baseInfo1;
95 wxClassInfo* m_baseInfo2;
96
97 static wxClassInfo* sm_first;
98 wxClassInfo* m_next;
99
100 static wxHashTable* sm_classTable;
c801d85f
KB
101};
102
184b5d99 103WXDLLEXPORT wxObject* wxCreateDynamicObject(const char *name);
c801d85f 104
9838df2c 105#if wxUSE_SERIAL
184b5d99 106WXDLLEXPORT wxObject* wxCreateStoredObject( wxInputStream& stream );
c801d85f
KB
107#endif
108
109#define DECLARE_DYNAMIC_CLASS(name) \
110 public:\
0c32066b 111 static wxClassInfo sm_class##name;\
8cb50e4b 112 wxClassInfo *GetClassInfo() const \
0c32066b 113 { return &name::sm_class##name; }
c801d85f
KB
114
115#define DECLARE_ABSTRACT_CLASS(name) DECLARE_DYNAMIC_CLASS(name)
116#define DECLARE_CLASS(name) DECLARE_DYNAMIC_CLASS(name)
117
c801d85f
KB
118//////
119////// for concrete classes
120//////
121
122// Single inheritance with one base class
123#define IMPLEMENT_DYNAMIC_CLASS(name, basename) \
124wxObject* WXDLLEXPORT_CTORFN wxConstructorFor##name(void) \
125 { return new name; }\
0c32066b 126 wxClassInfo name::sm_class##name((char *) #name, (char *) #basename, (char *) NULL, (int) sizeof(name), (wxObjectConstructorFn) wxConstructorFor##name);
c801d85f
KB
127
128// Multiple inheritance with two base classes
129#define IMPLEMENT_DYNAMIC_CLASS2(name, basename1, basename2) \
130wxObject* WXDLLEXPORT_CTORFN wxConstructorFor##name(void) \
131 { return new name; }\
0c32066b 132 wxClassInfo name::sm_class##name((char *) #name, (char *) #basename1, (char *) #basename2, (int) sizeof(name), (wxObjectConstructorFn) wxConstructorFor##name);
c801d85f 133
c801d85f
KB
134//////
135////// for abstract classes
136//////
137
138// Single inheritance with one base class
139#define IMPLEMENT_ABSTRACT_CLASS(name, basename) \
0c32066b 140 wxClassInfo name::sm_class##name((char *) #name, (char *) #basename, \
c67daf87 141 (char *) NULL, (int) sizeof(name), (wxObjectConstructorFn) NULL);
c801d85f
KB
142
143// Multiple inheritance with two base classes
144#define IMPLEMENT_ABSTRACT_CLASS2(name, basename1, basename2) \
0c32066b 145 wxClassInfo name::sm_class##name((char *) #name, (char *) #basename1, (char *) #basename2, (int) sizeof(name), (wxObjectConstructorFn) NULL);
c801d85f
KB
146
147#define IMPLEMENT_CLASS IMPLEMENT_ABSTRACT_CLASS
148#define IMPLEMENT_CLASS2 IMPLEMENT_ABSTRACT_CLASS2
149
0c32066b 150#define CLASSINFO(name) (&name::sm_class##name)
c801d85f
KB
151
152#else
153
154// No dynamic class system: so stub out the macros
155#define DECLARE_DYNAMIC_CLASS(name)
156#define DECLARE_ABSTRACT_CLASS(name)
157#define DECLARE_CLASS(name)
158#define IMPLEMENT_DYNAMIC_CLASS(name, basename)
159#define IMPLEMENT_DYNAMIC_CLASS2(name, basename1, basename2)
160#define IMPLEMENT_ABSTRACT_CLASS(name, basename)
161#define IMPLEMENT_ABSTRACT_CLASS2(name, basename1, basename2)
162#define IMPLEMENT_CLASS IMPLEMENT_ABSTRACT_CLASS
163#define IMPLEMENT_CLASS2 IMPLEMENT_ABSTRACT_CLASS2
164
165#endif
166
3013b6f4
JS
167#define wxIS_KIND_OF(obj, className) obj->IsKindOf(&className::sm_class##className)
168
169// Just seems a bit nicer-looking (pretend it's not a macro)
170#define wxIsKindOf(obj, className) obj->IsKindOf(&className::sm_class##className)
c801d85f
KB
171
172// Unfortunately Borland seems to need this include.
173#ifdef __BORLANDC__
47d67540 174#if wxUSE_IOSTREAMH
c801d85f
KB
175#include <iostream.h>
176#else
177#include <iostream>
178#endif
179#endif
180
181class WXDLLEXPORT wxObjectRefData;
182
183class WXDLLEXPORT wxObject
184{
185 public:
186
187 // This is equivalent to using the macro DECLARE_ABSTRACT_CLASS
0c32066b 188 static wxClassInfo sm_classwxObject;
c801d85f
KB
189
190 wxObject(void);
191 virtual ~wxObject(void);
192
8cb50e4b 193 virtual wxClassInfo *GetClassInfo(void) const { return &sm_classwxObject; }
c801d85f 194
8cb50e4b 195 bool IsKindOf(wxClassInfo *info) const;
c801d85f 196
ea57084d 197#if defined(__WXDEBUG__) && wxUSE_MEMORY_TRACING
c801d85f
KB
198 void * operator new (size_t size, char * fileName = NULL, int lineNum = 0);
199 void operator delete (void * buf);
27198be4 200
76626af2 201// VC++ 6.0
3f4a0c5b 202#if defined(__VISUALC__) && (__VISUALC__ >= 1200)
76626af2
JS
203 void operator delete(void *buf, char*, int);
204#endif
205
3f4a0c5b 206 // Causes problems for VC++
921b3c17 207#if wxUSE_ARRAY_MEMORY_OPERATORS && !defined(__VISUALC__) && !defined( __MWERKS__)
c801d85f
KB
208 void * operator new[] (size_t size, char * fileName = NULL, int lineNum = 0);
209 void operator delete[] (void * buf);
210#endif
211
27198be4
SC
212#ifdef __MWERKS__
213 void * operator new[] (size_t size, char * fileName , int lineNum = 0);
214 void operator delete[] (void * buf);
215#endif
216
3f4a0c5b 217#endif // Debug & memory tracing
c801d85f 218
ea57084d 219#if defined(__WXDEBUG__) || wxUSE_DEBUG_CONTEXT
c801d85f
KB
220 virtual void Dump(ostream& str);
221#endif
222
9838df2c 223#if wxUSE_SERIAL
7a4b9130
GL
224 virtual void StoreObject( wxObjectOutputStream &stream );
225 virtual void LoadObject( wxObjectInputStream &stream );
c801d85f
KB
226#endif
227
228 // make a 'clone' of the object
229 void Ref(const wxObject& clone);
230
231 // destroy a reference
232 void UnRef(void);
233
234 inline wxObjectRefData *GetRefData(void) const { return m_refData; }
235 inline void SetRefData(wxObjectRefData *data) { m_refData = data; }
236
237protected:
0c32066b 238 wxObjectRefData* m_refData;
9838df2c 239#if wxUSE_SERIAL
0c32066b 240 wxObject_Serialize* m_serialObj;
f4a8c29f 241#endif
c801d85f
KB
242};
243
244/*
245 * wxObjectData
246 */
247
248class WXDLLEXPORT wxObjectRefData {
249
250 friend class wxObject;
251
252public:
253 wxObjectRefData(void);
254 virtual ~wxObjectRefData(void);
255
256 inline int GetRefCount(void) const { return m_count; }
257private:
258 int m_count;
259};
260
7fe7d506
JS
261#ifdef __WXDEBUG__
262#ifndef WXDEBUG_NEW
263#define WXDEBUG_NEW new(__FILE__,__LINE__)
264#endif
265#else
266#define WXDEBUG_NEW new
267#endif
268
269// Redefine new to be the debugging version. This doesn't
270// work with all compilers, in which case you need to
271// use WXDEBUG_NEW explicitly if you wish to use the debugging version.
272
273#if defined(__WXDEBUG__) && wxUSE_GLOBAL_MEMORY_OPERATORS && wxUSE_DEBUG_NEW_ALWAYS
e55ad60e 274#define new new(__FILE__,__LINE__)
c801d85f
KB
275#endif
276
277#endif
34138703 278 // _WX_OBJECTH__
c801d85f
KB
279
280