include/wx/object.h

   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
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_OBJECTH__
  13 #define _WX_OBJECTH__
  14
  15 #ifdef __GNUG__
  16 #pragma interface "object.h"
  17 #endif
  18
  19 #include "wx/defs.h"
  20 #include "wx/memory.h"
  21
  22 class WXDLLEXPORT wxObject;
  23
  24 #if wxUSE_DYNAMIC_CLASSES
  25
  26 // #ifdef __GNUWIN32__
  27 #ifdef GetClassName
  28 #undef GetClassName
  29 #endif
  30 #ifdef GetClassInfo
  31 #undef GetClassInfo
  32 #endif
  33 // #endif
  34
  35 class WXDLLEXPORT wxClassInfo;
  36 class WXDLLEXPORT wxInputStream;
  37 class WXDLLEXPORT wxOutputStream;
  38 class WXDLLEXPORT wxObjectInputStream;
  39 class WXDLLEXPORT wxObjectOutputStream;
  40 class WXDLLEXPORT wxHashTable;
  41 class WXDLLEXPORT wxObject_Serialize;
  42
  43 #if wxUSE_STD_IOSTREAM && (defined(__WXDEBUG__) || wxUSE_DEBUG_CONTEXT)
  44   #include "wx/ioswrap.h"
  45 #endif
  46
  47 /*
  48  * Dynamic object system declarations
  49  */
  50
  51 typedef wxObject * (*wxObjectConstructorFn) (void);
  52
  53 class WXDLLEXPORT wxClassInfo
  54 {
  55  public:
  56    wxClassInfo(wxChar *cName, wxChar *baseName1, wxChar *baseName2, int sz, wxObjectConstructorFn fn);
  57
  58    wxObject *CreateObject(void);
  59
  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; }
  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; }
  67    static inline wxClassInfo* GetFirst() { return sm_first; }
  68    inline wxClassInfo* GetNext() const { return m_next; }
  69    bool IsKindOf(wxClassInfo *info) const;
  70
  71    static wxClassInfo *FindClass(wxChar *c);
  72
  73    // Initializes parent pointers and hash table for fast searching.
  74    static void InitializeClasses(void);
  75
  76    // Cleans up hash table used for fast searching.
  77    static void CleanUpClasses(void);
  78
  79 public:
  80    wxChar*                  m_className;
  81    wxChar*                  m_baseClassName1;
  82    wxChar*                  m_baseClassName2;
  83    int                      m_objectSize;
  84    wxObjectConstructorFn    m_objectConstructor;
  85
  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;
  95 };
  96
  97 WXDLLEXPORT wxObject* wxCreateDynamicObject(const wxChar *name);
  98
  99 #if wxUSE_SERIAL
 100 WXDLLEXPORT wxObject* wxCreateStoredObject( wxInputStream& stream );
 101 #endif
 102
 103 #define DECLARE_DYNAMIC_CLASS(name) \
 104  public:\
 105   static wxClassInfo sm_class##name;\
 106   wxClassInfo *GetClassInfo() const \
 107    { return &name::sm_class##name; }
 108
 109 #define DECLARE_ABSTRACT_CLASS(name) DECLARE_DYNAMIC_CLASS(name)
 110 #define DECLARE_CLASS(name) DECLARE_DYNAMIC_CLASS(name)
 111
 112 //////
 113 ////// for concrete classes
 114 //////
 115
 116 // Single inheritance with one base class
 117 #define IMPLEMENT_DYNAMIC_CLASS(name, basename) \
 118 wxObject* WXDLLEXPORT_CTORFN wxConstructorFor##name(void); \
 119 wxObject* WXDLLEXPORT_CTORFN wxConstructorFor##name(void) \
 120    { return new name; }\
 121  wxClassInfo name::sm_class##name((wxChar *) wxT(#name), (wxChar *) wxT(#basename), (wxChar *) NULL, (int) sizeof(name), (wxObjectConstructorFn) wxConstructorFor##name);
 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; }\
 127  wxClassInfo name::sm_class##name((wxChar *) wxT(#name), (wxChar *) wxT(#basename1), (wxChar *) wxT(#basename2), (int) sizeof(name), (wxObjectConstructorFn) wxConstructorFor##name);
 128
 129 //////
 130 ////// for abstract classes
 131 //////
 132
 133 // Single inheritance with one base class
 134 #define IMPLEMENT_ABSTRACT_CLASS(name, basename) \
 135  wxClassInfo name::sm_class##name((wxChar *) wxT(#name), (wxChar *) wxT(#basename), \
 136          (wxChar *) NULL, (int) sizeof(name), (wxObjectConstructorFn) NULL);
 137
 138 // Multiple inheritance with two base classes
 139 #define IMPLEMENT_ABSTRACT_CLASS2(name, basename1, basename2) \
 140  wxClassInfo name::sm_class##name((wxChar *) wxT(#name), (wxChar *) wxT(#basename1), \
 141          (wxChar *) wxT(#basename2), (int) sizeof(name), (wxObjectConstructorFn) NULL);
 142
 143 #define IMPLEMENT_CLASS IMPLEMENT_ABSTRACT_CLASS
 144 #define IMPLEMENT_CLASS2 IMPLEMENT_ABSTRACT_CLASS2
 145
 146 #define CLASSINFO(name) (&name::sm_class##name)
 147
 148 #else // !wxUSE_DYNAMIC_CLASSES
 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
 161 #endif // wxUSE_DYNAMIC_CLASSES/!wxUSE_DYNAMIC_CLASSES
 162
 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)
 167
 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
 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
 189 // Unfortunately Borland seems to need this include.
 190 #ifdef __BORLANDC__
 191     #if wxUSE_IOSTREAMH
 192         #include <iostream.h>
 193     #else
 194         #include <iostream>
 195     #endif
 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
 205   static wxClassInfo sm_classwxObject;
 206
 207   wxObject(void);
 208   virtual ~wxObject(void);
 209
 210   virtual wxClassInfo *GetClassInfo(void) const { return &sm_classwxObject; }
 211   wxObject *Clone(void) const;
 212   virtual void CopyObject(wxObject& object_dest) const;
 213
 214   bool IsKindOf(wxClassInfo *info) const;
 215
 216 #if defined(__WXDEBUG__) && wxUSE_MEMORY_TRACING
 217   void * operator new (size_t size, wxChar * fileName = NULL, int lineNum = 0);
 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
 224   void operator delete (void * buf);
 225 #endif
 226    // defined(__VISAGECPP__)
 227
 228 // VC++ 6.0
 229 #if defined(__VISUALC__) && (__VISUALC__ >= 1200)
 230   void operator delete(void *buf, wxChar*, int);
 231 #endif
 232
 233     // Causes problems for VC++
 234 #if wxUSE_ARRAY_MEMORY_OPERATORS && !defined(__VISUALC__) && !defined( __MWERKS__)
 235   void * operator new[] (size_t size, wxChar * fileName = NULL, int lineNum = 0);
 236   void operator delete[] (void * buf);
 237 #endif
 238
 239 #ifdef __MWERKS__
 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 ) ; }
 242   void operator delete[] (void * buf);
 243 #endif
 244
 245 #endif // Debug & memory tracing
 246
 247 #if wxUSE_STD_IOSTREAM && (defined(__WXDEBUG__) || wxUSE_DEBUG_CONTEXT)
 248   virtual void Dump(ostream& str);
 249 #endif
 250
 251 #if wxUSE_SERIAL
 252   virtual void StoreObject( wxObjectOutputStream &stream );
 253   virtual void LoadObject( wxObjectInputStream &stream );
 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
 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
 273 protected:
 274   wxObjectRefData*      m_refData;
 275 #if wxUSE_SERIAL
 276   wxObject_Serialize*   m_serialObj;
 277 #endif
 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
 297 #ifdef __WXDEBUG__
 298 #ifndef WXDEBUG_NEW
 299 #define WXDEBUG_NEW new(__TFILE__,__LINE__)
 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
 310 #define new new(__TFILE__,__LINE__)
 311 #endif
 312
 313 #endif
 314     // _WX_OBJECTH__
 315
 316