1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: runtime metadata information (extended class info)
4 // Author: Stefan Csomor
8 // Copyright: (c) 1997 Julian Smart
9 // (c) 2003 Stefan Csomor
10 // Licence: wxWindows licence
11 /////////////////////////////////////////////////////////////////////////////
16 #if defined(__GNUG__) && !defined(__APPLE__)
17 #pragma interface "xti.h"
20 // We want to support properties, event sources and events sinks through
21 // explicit declarations, using templates and specialization to make the
22 // effort as painless as possible.
24 // This means we have the following domains :
26 // - Type Information for categorizing built in types as well as custom types
27 // this includes information about enums, their values and names
28 // - Type safe value storage : a kind of wxVariant, called right now wxxVariant
29 // which will be merged with wxVariant
30 // - Property Information and Property Accessors providing access to a class'
31 // values and exposed event delegates
32 // - Information about event handlers
33 // - extended Class Information for accessing all these
35 // ----------------------------------------------------------------------------
37 // ----------------------------------------------------------------------------
40 #include "wx/memory.h"
42 #include "wx/string.h"
44 class WXDLLIMPEXP_BASE wxObject
;
45 class WXDLLIMPEXP_BASE wxClassInfo
;
46 class WXDLLIMPEXP_BASE wxHashTable
;
47 class WXDLLIMPEXP_BASE wxObjectRefData
;
48 class WXDLLIMPEXP_BASE wxEvent
;
50 typedef void (wxObject::*wxObjectEventFunction
)(wxEvent
&);
52 // ----------------------------------------------------------------------------
55 // In the header files there would no change from pure c++ code, in the
56 // implementation, an enum would have
57 // to be enumerated eg :
59 // WX_BEGIN_ENUM( wxFlavor )
60 // WX_ENUM_MEMBER( Vanilla )
61 // WX_ENUM_MEMBER( Chocolate )
62 // WX_ENUM_MEMBER( Strawberry )
63 // WX_END_ENUM( wxFlavor )
64 // ----------------------------------------------------------------------------
66 struct WXDLLIMPEXP_BASE wxEnumMemberData
72 class WXDLLIMPEXP_BASE wxEnumData
75 wxEnumData( wxEnumMemberData
* data
) ;
77 // returns true if the member has been found and sets the int value
78 // pointed to accordingly (if ptr != null )
79 // if not found returns false, value left unchanged
80 bool HasEnumMemberValue( const wxChar
*name
, int *value
= NULL
) ;
82 // returns the value of the member, if not found in debug mode an
83 // assert is issued, in release 0 is returned
84 int GetEnumMemberValue(const wxChar
*name
);
86 // returns the name of the enum member having the passed in value
87 // returns an emtpy string if not found
88 const wxChar
*GetEnumMemberName(int value
);
90 // returns the number of members in this enum
91 int GetEnumCount() { return m_count
; }
93 // returns the value of the nth member
94 int GetEnumMemberValueByIndex( int n
) ;
96 // returns the value of the nth member
97 const wxChar
*GetEnumMemberNameByIndex( int n
) ;
99 wxEnumMemberData
*m_members
;
103 #define WX_BEGIN_ENUM( e ) \
104 wxEnumMemberData s_enumDataMembers##e[] = {
106 #define WX_ENUM_MEMBER( v ) { #v, v } ,
108 #define WX_END_ENUM( e ) { NULL , 0 } } ; \
109 wxEnumData s_enumData##e( s_enumDataMembers##e ) ; \
110 wxEnumData *wxGetEnumData(e) { return &s_enumData##e ; } \
111 template<> const wxTypeInfo* wxGetTypeInfo( e * ){ static wxEnumTypeInfo s_typeInfo(wxT_ENUM , &s_enumData##e) ; return &s_typeInfo ; } \
112 template<> void wxStringReadValue(const wxString& s , e &data ) \
114 data = (e) s_enumData##e.GetEnumMemberValue(s) ; \
116 template<> void wxStringWriteValue(wxString &s , const e &data ) \
118 s = s_enumData##e.GetEnumMemberName((int)data) ; \
121 // ----------------------------------------------------------------------------
133 // typedef wxSet<wxFlavor> wxCoupe ;
135 // in the implementation file :
137 // WX_BEGIN_ENUM( wxFlavor )
138 // WX_ENUM_MEMBER( Vanilla )
139 // WX_ENUM_MEMBER( Chocolate )
140 // WX_ENUM_MEMBER( Strawberry )
141 // WX_END_ENUM( wxFlavor )
143 // WX_IMPLEMENT_SET_STREAMING( wxCoupe , wxFlavor )
145 // implementation note : no partial specialization for streaming, but a delegation to a
148 // ----------------------------------------------------------------------------
150 // in order to remove dependancy on string tokenizer
151 void wxSetStringToArray( const wxString
&s
, wxArrayString
&array
) ;
154 void wxSetFromString(const wxString
&s
, wxSet
<e
> &data
)
156 wxEnumData
* edata
= wxGetEnumData((e
) 0) ;
159 wxArrayString array
;
160 wxSetStringToArray( s
, array
) ;
162 for ( int i
= 0 ; i
< array
.Count() ; ++i
)
166 if ( edata
->HasEnumMemberValue( flag
, &ivalue
) )
168 data
.Set( (e
) ivalue
) ;
174 void wxSetToString( wxString
&s
, const wxSet
<e
> &data
)
176 wxEnumData
* edata
= wxGetEnumData((e
) 0) ;
177 int count
= edata
->GetEnumCount() ;
180 for ( i
= 0 ; i
< count
; i
++ )
182 e value
= (e
) edata
->GetEnumMemberValueByIndex(i
) ;
183 if ( data
.Contains( value
) )
185 // this could also be done by the templated calls
188 s
+= edata
->GetEnumMemberNameByIndex(i
) ;
193 // if the wxSet specialization above does not work for all compilers, add this to the WX_IMPLEMENT_SET_STREAMING macro
194 // template<> const wxTypeInfo* wxGetTypeInfo( SetName * ){ static wxEnumTypeInfo s_typeInfo(wxT_SET , &s_enumData##e) ; return &s_typeInfo ; }\
196 #define WX_IMPLEMENT_SET_STREAMING(SetName,e) \
197 template<> void wxStringReadValue(const wxString &s , wxSet<e> &data ) \
199 wxSetFromString( s , data ) ; \
201 template<> void wxStringWriteValue( wxString &s , const wxSet<e> &data ) \
203 wxSetToString( s , data ) ; \
207 // ----------------------------------------------------------------------------
209 // ----------------------------------------------------------------------------
213 wxT_VOID
= 0, // unknown type
223 wxT_STRING
, // must be wxString
224 wxT_SET
, // must be wxSet<> template
226 wxT_OBJECT
, // must be a component (pointer !!!)
227 wxT_CUSTOM
, // user defined type (e.g. wxPoint)
228 wxT_DELEGATE
, // for connecting against an event source
229 wxT_LAST_TYPE_KIND
// sentinel for bad data, asserts, debugging
232 class WXDLLIMPEXP_BASE wxTypeInfo
235 wxTypeInfo() : m_kind( wxT_VOID
) {}
236 virtual ~wxTypeInfo() {}
237 wxTypeKind
GetKind() const { return m_kind
; }
242 class WXDLLIMPEXP_BASE wxBuiltInTypeInfo
: public wxTypeInfo
245 wxBuiltInTypeInfo( wxTypeKind kind
) { assert( kind
< wxT_SET
) ; m_kind
= kind
;}
248 class WXDLLIMPEXP_BASE wxCustomTypeInfo
: public wxTypeInfo
251 wxCustomTypeInfo( const wxChar
*typeName
)
252 { m_kind
= wxT_CUSTOM
; m_typeName
= typeName
;}
253 const wxChar
*GetTypeName() const { assert( m_kind
== wxT_CUSTOM
) ; return m_typeName
; }
255 const wxChar
*m_typeName
; // Kind == wxT_CUSTOM
258 class WXDLLIMPEXP_BASE wxEnumTypeInfo
: public wxTypeInfo
261 wxEnumTypeInfo( wxTypeKind kind
, wxEnumData
* enumInfo
)
262 { assert( kind
== wxT_ENUM
|| kind
== wxT_SET
) ; m_kind
= kind
; m_enumInfo
= enumInfo
;}
263 const wxEnumData
* GetEnumData() const { assert( m_kind
== wxT_ENUM
|| m_kind
== wxT_SET
) ; return m_enumInfo
; }
265 wxEnumData
*m_enumInfo
; // Kind == wxT_ENUM or Kind == wxT_SET
268 class WXDLLIMPEXP_BASE wxClassTypeInfo
: public wxTypeInfo
271 wxClassTypeInfo( wxClassInfo
* classInfo
)
272 { m_kind
= wxT_OBJECT
; m_classInfo
= classInfo
;}
273 const wxClassInfo
*GetClassInfo() const { assert( m_kind
== wxT_OBJECT
) ; return m_classInfo
; }
275 wxClassInfo
*m_classInfo
; // Kind == wxT_OBJECT - could be NULL
278 // a delegate is an exposed event source
280 class WXDLLIMPEXP_BASE wxDelegateTypeInfo
: public wxTypeInfo
283 wxDelegateTypeInfo( int eventType
, wxClassInfo
* eventClass
)
284 { m_kind
= wxT_DELEGATE
; m_eventClass
= eventClass
; m_eventType
= eventType
;}
285 const wxClassInfo
*GetEventClass() const { assert( m_kind
== wxT_DELEGATE
) ; return m_eventClass
; }
286 int GetEventType() const { assert( m_kind
== wxT_DELEGATE
) ; return m_eventType
; }
288 const wxClassInfo
*m_eventClass
; // (extended will merge into classinfo)
292 template<typename T
> const wxTypeInfo
* wxGetTypeInfo( T
* ) ;
294 template<typename T
> const wxTypeInfo
* wxGetTypeInfo( wxSet
<T
> * )
296 static wxEnumTypeInfo
s_typeInfo(wxT_SET
, wxGetEnumData((T
) 0) ) ; return &s_typeInfo
;
299 // this macro is for usage with custom, non-object derived classes and structs, wxPoint is such a custom type
301 #define WX_CUSTOM_TYPE_INFO( e ) \
302 template<> const wxTypeInfo* wxGetTypeInfo( e * ){ static wxCustomTypeInfo s_typeInfo(#e) ; return &s_typeInfo ; } \
304 // ----------------------------------------------------------------------------
307 // streaming is defined for xml constructs right now, the aim is to make this
308 // pluggable in the future
309 // ----------------------------------------------------------------------------
311 // convenience function (avoids including xml headers in users code)
314 void wxXmlAddContentToNode( wxXmlNode
* node
, const wxString
& data
) ;
315 wxString
wxXmlGetContentFromNode( wxXmlNode
*node
) ;
317 // templated streaming, every type must have their specialization for these methods
320 void wxStringReadValue( const wxString
&s
, T
&data
) ;
323 void wxStringWriteValue( wxString
&s
, const T
&data
) ;
325 // for simple types this default implementation is ok, composited structures will have to
326 // loop through their properties
329 void wxXmlReadValue( wxXmlNode
*node
, T
&data
)
331 wxStringReadValue
<T
>( wxXmlGetContentFromNode( node
) , data
) ;
335 void wxXmlWriteValue( wxXmlNode
*node
, const T
&data
)
338 wxStringWriteValue
<T
>( s
, data
) ;
339 wxXmlAddContentToNode( node
,s
) ;
342 // ----------------------------------------------------------------------------
343 // wxxVariant as typesafe data holder
344 // ----------------------------------------------------------------------------
346 class WXDLLIMPEXP_BASE wxxVariantData
349 virtual ~wxxVariantData() {}
351 // return a heap allocated duplicate
352 virtual wxxVariantData
* Clone() const = 0 ;
354 // returns the type info of the contentc
355 virtual const wxTypeInfo
* GetTypeInfo() const = 0 ;
357 // write the value into an xml node
358 virtual void Write( wxXmlNode
* node
) const = 0 ;
360 // read the value from the xml node
361 virtual void Read( wxXmlNode
* node
) = 0 ;
363 // write the value into a string
364 virtual void Write( wxString
&s
) const = 0 ;
366 // read the value from a string
367 virtual void Read( const wxString
&s
) = 0 ;
370 template<typename T
> class WXDLLIMPEXP_BASE wxxVariantDataT
: public wxxVariantData
373 wxxVariantDataT(T d
) : m_data(d
) {}
374 virtual ~wxxVariantDataT() {}
376 // get a copy of the stored data
377 T
Get() const { return m_data
; }
380 void Set(T d
) { m_data
= d
; }
382 // return a heap allocated duplicate
383 virtual wxxVariantData
* Clone() const { return new wxxVariantDataT
<T
>( Get() ) ; }
385 // returns the type info of the contentc
386 virtual const wxTypeInfo
* GetTypeInfo() const { return wxGetTypeInfo( (T
*) NULL
) ; }
388 // write the value into an xml node
389 virtual void Write( wxXmlNode
* node
) const { wxXmlWriteValue( node
, m_data
) ; }
391 // read the value from the xml node
392 virtual void Read( wxXmlNode
* node
) { wxXmlReadValue( node
, m_data
) ; }
394 // write the value into a string
395 virtual void Write( wxString
&s
) const { wxStringWriteValue( s
, m_data
) ; }
397 // read the value from a string
398 virtual void Read( const wxString
&s
) { wxStringReadValue( s
, m_data
) ; }
404 class WXDLLIMPEXP_BASE wxxVariant
407 wxxVariant() { m_data
= NULL
; }
408 wxxVariant( wxxVariantData
* data
, const wxString
& name
= wxT("") ) : m_data(data
) , m_name(name
) {}
409 wxxVariant( const wxxVariant
&d
) { if ( d
.m_data
) m_data
= d
.m_data
->Clone() ; else m_data
= NULL
; m_name
= d
.m_name
; }
411 template<typename T
> wxxVariant( T data
, const wxString
& name
= wxT("") ) :
412 m_data(new wxxVariantDataT
<T
>(data
) ), m_name(name
) {}
413 ~wxxVariant() { delete m_data
; }
415 // get a copy of the stored data
416 template<typename T
> T
Get() const
418 wxxVariantDataT
<T
> *dataptr
= dynamic_cast<wxxVariantDataT
<T
>*> (m_data
) ;
420 return dataptr
->Get() ;
424 template<typename T
> Set(T data
) const
427 m_data
= new wxxVariantDataT
<T
>(data
) ;
430 wxxVariant
& operator=(const wxxVariant
&d
)
432 m_data
= d
.m_data
->Clone() ;
437 // gets the stored data casted to a wxObject* , returning NULL if cast is not possible
438 wxObject
* GetAsObject() const ;
440 // write the value into an xml node
441 void Write( wxXmlNode
* node
) const { m_data
->Write( node
) ; }
443 // read the value from the xml node
444 void Read( wxXmlNode
* node
) { m_data
->Read( node
) ; }
446 // write the value into a string
447 void Write( wxString
&s
) const { m_data
->Write( s
) ; }
449 // read the value from a string
450 void Read( const wxString
&s
) { m_data
->Read( s
) ; }
452 // returns this value as string
453 wxString
GetAsString() const
460 void SetFromString( const wxString
&s
)
465 wxxVariantData
* m_data
;
469 // ----------------------------------------------------------------------------
472 // wxPropertyInfo is used to inquire of the property by name. It doesn't
473 // provide access to the property, only information about it. If you
474 // want access, look at wxPropertyAccessor.
475 // ----------------------------------------------------------------------------
477 class WXDLLIMPEXP_BASE wxPropertyAccessor
480 virtual void SetProperty(wxObject
*object
, const wxxVariant
&value
) const = 0 ;
481 virtual wxxVariant
GetProperty(wxObject
*object
) const = 0 ;
482 virtual bool HasSetter() const = 0 ;
483 virtual bool HasGetter() const = 0 ;
484 const char * GetGetterName() const { return m_setterName
; }
485 const char * GetSetterName() const { return m_getterName
; }
486 virtual wxxVariant
ReadValue( wxXmlNode
* node
) const = 0 ;
487 virtual void WriteValue( wxXmlNode
* node
, wxObject
*o
) const = 0 ;
488 virtual wxxVariant
ReadValue( const wxString
&value
) const = 0 ;
489 virtual void WriteValue( wxString
& value
, wxObject
*o
) const = 0 ;
491 const char *m_setterName
;
492 const char *m_getterName
;
496 void wxXmlReadValue( wxXmlNode
*node
, T
&data
) ;
499 void wxXmlWriteValue( wxXmlNode
*node
, const T
&data
) ;
501 template<class Klass
, typename T
>
502 class WXDLLIMPEXP_BASE wxPropertyAccessorT
: public wxPropertyAccessor
505 typedef void (Klass::*setter_t
)(T value
);
506 typedef void (Klass::*setter_ref_t
)(T
& value
);
507 typedef T (Klass::*getter_t
)() const;
508 typedef const T
& (Klass::*getter_ref_t
)() const;
510 wxPropertyAccessorT(setter_t setter
, getter_t getter
, const char *g
, const char *s
)
511 : m_setter(setter
), m_setter_ref(NULL
), m_getter(getter
) ,m_getter_ref(NULL
) {m_setterName
= s
;m_getterName
=g
;}
512 wxPropertyAccessorT(setter_ref_t setter
, getter_t getter
, const char *g
, const char *s
)
513 : m_setter(NULL
), m_setter_ref(setter
), m_getter(getter
) , m_getter_ref(NULL
){m_setterName
= s
;m_getterName
=g
;}
514 wxPropertyAccessorT(setter_ref_t setter
, getter_ref_t getter
, const char *g
, const char *s
)
515 : m_setter(NULL
), m_setter_ref(setter
), m_getter(NULL
) , m_getter_ref(getter
){m_setterName
= s
;m_getterName
=g
;}
516 wxPropertyAccessorT(setter_t setter
, getter_ref_t getter
, const char *g
, const char *s
)
517 : m_setter(NULL
), m_setter(setter
), m_getter(NULL
) , m_getter_ref(getter
){m_setterName
= s
;m_getterName
=g
;}
519 // returns true if this accessor has a setter
520 bool HasSetter() const { return m_setter
!= NULL
|| m_setter_ref
!= NULL
; }
522 // return true if this accessor has a getter
523 bool HasGetter() const { return m_getter
!= NULL
|| m_getter_ref
!= NULL
; }
525 // set the property this accessor is responsible for in an object
526 void SetProperty(wxObject
*o
, const wxxVariant
&v
) const
528 Klass
*obj
= dynamic_cast<Klass
*>(o
);
529 T value
= v
.Get
<T
>();
531 (obj
->*(m_setter
))(value
);
533 (obj
->*(m_setter_ref
))(value
);
536 // gets the property this accessor is responsible for from an object
537 wxxVariant
GetProperty(wxObject
*o
) const
539 return wxxVariant( (wxxVariantData
* ) DoGetProperty( o
) ) ;
542 // write the property this accessor is responsible for from an object into
544 void WriteValue( wxXmlNode
* node
, wxObject
*o
) const
546 DoGetProperty( o
)->Write( node
) ;
549 // write the property this accessor is responsible for from an object into
551 void WriteValue( wxString
& s
, wxObject
*o
) const
553 DoGetProperty( o
)->Write( s
) ;
556 // read a wxxVariant having the correct type for the property this accessor
557 // is responsible for from an xml node
558 wxxVariant
ReadValue( wxXmlNode
* node
) const
561 wxXmlReadValue( node
, data
) ;
562 return wxxVariant( data
) ;
565 // read a wxxVariant having the correct type for the property this accessor
566 // is responsible for from a string
567 wxxVariant
ReadValue( const wxString
&value
) const
570 wxStringReadValue( value
, data
) ;
571 return wxxVariant( data
) ;
575 wxxVariantDataT
<T
>* DoGetProperty(wxObject
*o
) const
577 Klass
*obj
= dynamic_cast<Klass
*>(o
);
579 return new wxxVariantDataT
<T
>( (obj
->*(m_getter
))() ) ;
581 return new wxxVariantDataT
<T
>( (obj
->*(m_getter_ref
))() ) ;
585 setter_ref_t m_setter_ref
;
587 getter_ref_t m_getter_ref
;
590 class WXDLLIMPEXP_BASE wxPropertyInfo
593 wxPropertyInfo( wxPropertyInfo
* &iter
, const char *name
, const char *typeName
, const wxTypeInfo
* typeInfo
, wxPropertyAccessor
*accessor
, wxxVariant dv
) :
594 m_name( name
) , m_typeName(typeName
) , m_typeInfo( typeInfo
) , m_accessor( accessor
) , m_defaultValue( dv
)
599 // return the name of this property
600 const char * GetName() const { return m_name
; }
602 // return the typename of this property
603 const char * GetTypeName() const { return m_typeName
; }
605 // return the type info of this property
606 const wxTypeInfo
* GetTypeInfo() const { return m_typeInfo
; }
608 // return the accessor for this property
609 wxPropertyAccessor
* GetAccessor() const { return m_accessor
; }
611 // returns NULL if this is the last property of this class
612 wxPropertyInfo
* GetNext() const { return m_next
; }
615 const char * m_typeName
;
616 const wxTypeInfo
* m_typeInfo
;
617 wxPropertyAccessor
* m_accessor
;
618 wxxVariant m_defaultValue
;
619 // string representation of the default value
620 // to be assigned by the designer to the property
621 // when the component is dropped on the container.
622 wxPropertyInfo
* m_next
;
625 #define WX_BEGIN_PROPERTIES_TABLE(theClass) \
626 const wxPropertyInfo *theClass::GetPropertiesStatic() \
628 typedef theClass class_t; \
629 static wxPropertyInfo* first = NULL ;
631 #define WX_END_PROPERTIES_TABLE() \
634 #define WX_PROPERTY( name , type , setter , getter ,defaultValue ) \
635 static wxPropertyAccessorT<class_t , type> _accessor##name( setter , getter , #setter , #getter ) ; \
636 static wxPropertyInfo _propertyInfo##name( first , #name , #type , wxGetTypeInfo( (type*) NULL ) ,&_accessor##name , wxxVariant(defaultValue) ) ;
638 #define WX_DELEGATE( name , eventType , eventClass ) \
639 static wxDelegateTypeInfo _typeInfo##name( eventType , CLASSINFO( eventClass ) ) ; \
640 static wxPropertyInfo _propertyInfo##name( first , #name , NULL , &_typeInfo##name , NULL , wxxVariant() ) ; \
642 // ----------------------------------------------------------------------------
645 // this is describing an event sink
646 // ----------------------------------------------------------------------------
651 wxHandlerInfo( wxHandlerInfo
* &iter
, const wxChar
*name
, wxObjectEventFunction address
, const wxClassInfo
* eventClassInfo
) :
652 m_name( name
) , m_eventClassInfo( eventClassInfo
) , m_eventFunction( address
)
658 // get the name of the handler method
659 const char * GetName() const { return m_name
; }
661 // return the class info of the event
662 const wxClassInfo
* GetEventClassInfo() const { return m_eventClassInfo
; }
664 // get the handler function pointer
665 wxObjectEventFunction
GetEventFunction() const { return m_eventFunction
; }
667 // returns NULL if this is the last handler of this class
668 wxHandlerInfo
* GetNext() const { return m_next
; }
670 const wxChar
* m_name
;
671 wxObjectEventFunction m_eventFunction
;
672 const wxClassInfo
* m_eventClassInfo
;
673 wxHandlerInfo
* m_next
;
676 #define WX_HANDLER(name,eventClassType) \
677 static wxHandlerInfo _handlerInfo##name( first , #name , (wxObjectEventFunction) &name , CLASSINFO( eventClassType ) ) ;
679 #define WX_BEGIN_HANDLERS_TABLE(theClass) \
680 const wxHandlerInfo *theClass::GetHandlersStatic() \
682 typedef theClass class_t; \
683 static wxHandlerInfo* first = NULL ;
685 #define WX_END_HANDLERS_TABLE() \
688 // ----------------------------------------------------------------------------
689 // Constructor Bridges
691 // allow to set up constructors with params during runtime
692 // ----------------------------------------------------------------------------
694 class WXDLLIMPEXP_BASE wxConstructorBridge
697 virtual void Create(wxObject
*o
, wxxVariant
*args
) = 0;
700 // Creator Bridges for all Numbers of Params
704 template<typename Class
>
705 struct wxConstructorBridge_0
: public wxConstructorBridge
707 void Create(wxObject
*o
, wxxVariant
*)
709 Class
*obj
= dynamic_cast<Class
*>(o
);
714 struct wxConstructorBridge_Dummy
: public wxConstructorBridge
716 void Create(wxObject
*, wxxVariant
*)
721 #define WX_CONSTRUCTOR_0(klass) \
722 wxConstructorBridge_0<klass> constructor##klass ; \
723 wxConstructorBridge* klass::sm_constructor##klass = &constructor##klass ; \
724 const char *klass::sm_constructorProperties##klass[] = { NULL } ; \
725 const int klass::sm_constructorPropertiesCount##klass = 0 ;
727 #define WX_CONSTRUCTOR_DUMMY(klass) \
728 wxConstructorBridge_Dummy constructor##klass ; \
729 wxConstructorBridge* klass::sm_constructor##klass = &constructor##klass ; \
730 const char *klass::sm_constructorProperties##klass[] = { NULL } ; \
731 const int klass::sm_constructorPropertiesCount##klass = 0 ;
735 template<typename Class
, typename T0
>
736 struct wxConstructorBridge_1
: public wxConstructorBridge
738 void Create(wxObject
*o
, wxxVariant
*args
)
740 Class
*obj
= dynamic_cast<Class
*>(o
);
747 #define WX_CONSTRUCTOR_1(klass,t0,v0) \
748 wxConstructorBridge_1<klass,t0> constructor##klass ; \
749 wxConstructorBridge* klass::sm_constructor##klass = &constructor##klass ; \
750 const char *klass::sm_constructorProperties##klass[] = { #v0 } ; \
751 const int klass::sm_constructorPropertiesCount##klass = 1 ;
755 template<typename Class
,
756 typename T0
, typename T1
>
757 struct wxConstructorBridge_2
: public wxConstructorBridge
759 void Create(wxObject
*o
, wxxVariant
*args
[])
761 Class
*obj
= dynamic_cast<Class
*>(o
);
769 #define WX_CONSTRUCTOR_2(klass,t0,v0,t1,v1) \
770 wxConstructorBridge_2<klass,t0,t1> constructor##klass ; \
771 klass::sm_constructor##klass = &constructor##klass ; \
772 klass::sm_constructorProperties##klass[] = { #v0 , #v1 } ; \
773 klass::sm_constructorPropertiesCount##klass = 2;
777 template<typename Class
,
778 typename T0
, typename T1
, typename T2
>
779 struct wxConstructorBridge_3
: public wxConstructorBridge
781 void Create(wxObject
*o
, wxxVariant
*args
[])
783 Class
*obj
= dynamic_cast<Class
*>(o
);
792 #define WX_CONSTRUCTOR_3(klass,t0,v0,t1,v1,t2,v2) \
793 wxConstructorBridge_3<klass,t0,t1,t2> constructor##klass ; \
794 klass::sm_constructor##klass = &constructor##klass ; \
795 klass::sm_constructorProperties##klass[] = { #v0 , #v1 , #v2 } ; \
796 klass::sm_constructorPropertiesCount##klass = 3 ;
800 template<typename Class
,
801 typename T0
, typename T1
, typename T2
, typename T3
>
802 struct wxConstructorBridge_4
: public wxConstructorBridge
804 void Create(wxObject
*o
, wxxVariant
*args
[])
806 Class
*obj
= dynamic_cast<Class
*>(o
);
816 #define WX_CONSTRUCTOR_4(klass,t0,v0,t1,v1,t2,v2,t3,v3) \
817 wxConstructorBridge_4<klass,t0,t1,t2,t3> constructor##klass ; \
818 klass::sm_constructor##klass = &constructor##klass ; \
819 klass::sm_constructorProperties##klass[] = { #v0 , #v1 , #v2 , #v3 } ; \
820 klass::sm_constructorPropertiesCount##klass = 4 ;
822 // ----------------------------------------------------------------------------
824 // ----------------------------------------------------------------------------
826 typedef wxObject
*(*wxObjectConstructorFn
)(void);
827 typedef wxObject
* (*wxVariantToObjectConverter
)( const wxxVariant
&data
) ;
828 typedef wxxVariant (*wxObjectToVariantConverter
)( wxObject
* ) ;
830 class WXDLLIMPEXP_BASE wxClassInfo
833 wxClassInfo(const wxClassInfo
**_Parents
,
834 const char *_UnitName
,
835 const char *_ClassName
,
837 wxObjectConstructorFn ctor
,
838 const wxPropertyInfo
*_Props
,
839 wxConstructorBridge
* _Constructor
,
840 const char ** _ConstructorProperties
,
841 const int _ConstructorPropertiesCount
,
842 wxVariantToObjectConverter _Converter1
,
843 wxObjectToVariantConverter _Converter2
844 ) : m_parents(_Parents
) , m_unitName(_UnitName
) ,m_className(_ClassName
),
845 m_objectSize(size
), m_objectConstructor(ctor
) , m_firstProperty(_Props
) , m_constructor( _Constructor
) ,
846 m_constructorProperties(_ConstructorProperties
) , m_constructorPropertiesCount(_ConstructorPropertiesCount
),
847 m_variantToObjectConverter( _Converter1
) , m_objectToVariantConverter( _Converter2
) , m_next(sm_first
)
850 Register( m_className
, this ) ;
855 wxObject
*CreateObject() { return m_objectConstructor
? (*m_objectConstructor
)() : 0; }
857 const wxChar
*GetClassName() const { return m_className
; }
858 const wxClassInfo
**GetParents() const { return m_parents
; }
859 int GetSize() const { return m_objectSize
; }
861 wxObjectConstructorFn
GetConstructor() const { return m_objectConstructor
; }
862 static const wxClassInfo
*GetFirst() { return sm_first
; }
863 const wxClassInfo
*GetNext() const { return m_next
; }
864 static wxClassInfo
*FindClass(const wxChar
*className
);
866 // Climb upwards through inheritance hierarchy.
867 // Dual inheritance is catered for.
869 bool IsKindOf(const wxClassInfo
*info
) const
876 for ( int i
= 0 ; m_parents
[i
] ; ++ i
)
878 if ( m_parents
[i
]->IsKindOf( info
) )
885 // Initializes parent pointers and hash table for fast searching.
886 // this is going to be removed by Register/Unregister calls
887 // in Constructor / Destructor together with making the hash map private
889 static void InitializeClasses();
891 // Cleans up hash table used for fast searching.
893 static void CleanUpClasses();
895 // returns the first property
896 const wxPropertyInfo
* GetFirstProperty() const { return m_firstProperty
; }
898 // returns the first handler
899 const wxHandlerInfo
* GetFirstHandler() const { return m_firstHandler
; }
901 // Call the Create method for a class
902 virtual void Create (wxObject
*object
, int ParamCount
, wxxVariant
*Params
)
904 wxASSERT( ParamCount
== m_constructorPropertiesCount
) ;
905 m_constructor
->Create( object
, Params
) ;
908 // get number of parameters for constructor
909 virtual int GetCreateParamCount() const { return m_constructorPropertiesCount
; }
911 // get i-th constructor parameter
912 virtual const wxChar
* GetCreateParamName(int i
) const { return m_constructorProperties
[i
] ; }
914 // Runtime access to objects by property name, and variant data
915 virtual void SetProperty (wxObject
*object
, const char *PropertyName
, const wxxVariant
&Value
);
916 virtual wxxVariant
GetProperty (wxObject
*object
, const char *PropertyName
);
918 // we must be able to cast variants to wxObject pointers, templates seem not to be suitable
919 wxObject
* VariantToInstance( const wxxVariant
&data
) const { return m_variantToObjectConverter( data
) ; }
920 wxxVariant
InstanceToVariant( wxObject
*object
) const { return m_objectToVariantConverter( object
) ; }
922 // find property by name
923 virtual const wxPropertyInfo
*FindPropInfo (const char *PropertyName
) const ;
926 const wxChar
*m_className
;
928 wxObjectConstructorFn m_objectConstructor
;
930 // class info object live in a linked list:
931 // pointers to its head and the next element in it
933 static wxClassInfo
*sm_first
;
936 // FIXME: this should be private (currently used directly by way too
938 static wxHashTable
*sm_classTable
;
941 const wxClassInfo
** m_parents
;
942 const wxPropertyInfo
* m_firstProperty
;
943 const wxHandlerInfo
* m_firstHandler
;
944 const wxChar
* m_unitName
;
946 wxConstructorBridge
* m_constructor
;
947 const wxChar
** m_constructorProperties
;
948 const int m_constructorPropertiesCount
;
949 wxVariantToObjectConverter m_variantToObjectConverter
;
950 wxObjectToVariantConverter m_objectToVariantConverter
;
952 const wxPropertyAccessor
*FindAccessor (const char *propertyName
);
954 // registers the class
955 static void Register(const wxChar
*name
, wxClassInfo
*info
);
957 static void Unregister(const wxChar
*name
);
959 // InitializeClasses() helper
960 static wxClassInfo
*GetBaseByName(const wxChar
*name
);
962 DECLARE_NO_COPY_CLASS(wxClassInfo
)
965 WXDLLIMPEXP_BASE wxObject
*wxCreateDynamicObject(const wxChar
*name
);
967 // ----------------------------------------------------------------------------
968 // Dynamic class macros
969 // ----------------------------------------------------------------------------
971 #define _DECLARE_DYNAMIC_CLASS(name) \
973 static wxClassInfo sm_class##name; \
974 static const wxClassInfo* sm_classParents##name[] ; \
975 static const wxPropertyInfo* GetPropertiesStatic() ; \
976 static const wxHandlerInfo* GetHandlersStatic() ; \
977 virtual wxClassInfo *GetClassInfo() const \
978 { return &name::sm_class##name; }
980 #define DECLARE_DYNAMIC_CLASS(name) \
981 _DECLARE_DYNAMIC_CLASS(name) \
982 static wxConstructorBridge* sm_constructor##name ; \
983 static const char * sm_constructorProperties##name[] ; \
984 static const int sm_constructorPropertiesCount##name ;
986 #define DECLARE_DYNAMIC_CLASS_NO_ASSIGN(name) \
987 DECLARE_NO_ASSIGN_CLASS(name) \
988 DECLARE_DYNAMIC_CLASS(name)
990 #define DECLARE_DYNAMIC_CLASS_NO_COPY(name) \
991 DECLARE_NO_COPY_CLASS(name) \
992 DECLARE_DYNAMIC_CLASS(name)
994 #define DECLARE_ABSTRACT_CLASS(name) _DECLARE_DYNAMIC_CLASS(name)
995 #define DECLARE_CLASS(name) DECLARE_DYNAMIC_CLASS(name)
997 // -----------------------------------
998 // for concrete classes
999 // -----------------------------------
1001 // Single inheritance with one base class
1003 #define _IMPLEMENT_DYNAMIC_CLASS(name, basename, unit) \
1004 wxObject* wxConstructorFor##name() \
1005 { return new name; } \
1006 const wxClassInfo* name::sm_classParents##name[] = { &basename::sm_class##basename ,NULL } ; \
1007 wxObject* wxVariantToObjectConverter##name ( const wxxVariant &data ) { return data.Get<name*>() ; } \
1008 wxxVariant wxObjectToVariantConverter##name ( wxObject *data ) { return wxxVariant( dynamic_cast<name*> (data) ) ; } \
1009 wxClassInfo name::sm_class##name(sm_classParents##name , wxT(unit) , wxT(#name), \
1010 (int) sizeof(name), \
1011 (wxObjectConstructorFn) wxConstructorFor##name , \
1012 name::GetPropertiesStatic(),name::sm_constructor##name , name::sm_constructorProperties##name , \
1013 name::sm_constructorPropertiesCount##name , wxVariantToObjectConverter##name , wxObjectToVariantConverter##name); \
1014 template<> void wxStringReadValue(const wxString & , name * & ){assert(0) ;}\
1015 template<> void wxStringWriteValue(wxString & , name* const & ){assert(0) ;}\
1016 template<> const wxTypeInfo* wxGetTypeInfo( name ** ){ static wxClassTypeInfo s_typeInfo(&name::sm_class##name) ; return &s_typeInfo ; }
1018 #define IMPLEMENT_DYNAMIC_CLASS( name , basename ) \
1019 _IMPLEMENT_DYNAMIC_CLASS( name , basename , "" ) \
1020 const wxPropertyInfo *name::GetPropertiesStatic() { return (wxPropertyInfo*) NULL ; } \
1021 WX_CONSTRUCTOR_DUMMY( name )
1023 #define IMPLEMENT_DYNAMIC_CLASS_XTI( name , basename , unit ) \
1024 _IMPLEMENT_DYNAMIC_CLASS( name , basename , unit )
1026 // this is for classes that do not derive from wxobject, there are no creators for these
1028 #define IMPLEMENT_DYNAMIC_CLASS_NO_WXOBJECT_NO_BASE_XTI( name , unit ) \
1029 const wxClassInfo* name::sm_classParents##name[] = { NULL } ; \
1030 wxClassInfo name::sm_class##name(sm_classParents##name , wxT("") , wxT(#name), \
1031 (int) sizeof(name), \
1032 (wxObjectConstructorFn) 0 , \
1033 name::GetPropertiesStatic(),0 , 0 , \
1035 template<> void wxStringReadValue(const wxString & , name * & ){assert(0) ;}\
1036 template<> void wxStringWriteValue(wxString & , name* const & ){assert(0) ;}\
1037 template<> const wxTypeInfo* wxGetTypeInfo( name ** ){ static wxClassTypeInfo s_typeInfo(&name::sm_class##name) ; return &s_typeInfo ; }
1039 // this is for subclasses that still do not derive from wxobject
1041 #define IMPLEMENT_DYNAMIC_CLASS_NO_WXOBJECT_XTI( name , basename, unit ) \
1042 const wxClassInfo* name::sm_classParents##name[] = { &basename::sm_class##basename ,NULL } ; \
1043 wxClassInfo name::sm_class##name(sm_classParents##name , wxT("") , wxT(#name), \
1044 (int) sizeof(name), \
1045 (wxObjectConstructorFn) 0 , \
1046 name::GetPropertiesStatic(),0 , 0 , \
1048 template<> void wxStringReadValue(const wxString & , name * & ){assert(0) ;}\
1049 template<> void wxStringWriteValue(wxString & , name* const & ){assert(0) ;}\
1050 template<> const wxTypeInfo* wxGetTypeInfo( name ** ){ static wxClassTypeInfo s_typeInfo(&name::sm_class##name) ; return &s_typeInfo ; }
1052 // Multiple inheritance with two base classes
1054 #define _IMPLEMENT_DYNAMIC_CLASS2(name, basename, basename2, unit) \
1055 wxObject* wxConstructorFor##name() \
1056 { return new name; } \
1057 const wxClassInfo* name::sm_classParents##name[] = { &basename::sm_class##basename ,&basename2::sm_class##basename2 , NULL } ; \
1058 wxObject* wxVariantToObjectConverter##name ( const wxxVariant &data ) { return data.Get<name*>() ; } \
1059 wxxVariant wxObjectToVariantConverter##name ( wxObject *data ) { return wxxVariant( dynamic_cast<name*> (data) ) ; } \
1060 wxClassInfo name::sm_class##name(sm_classParents##name , wxT(unit) , wxT(#name), \
1061 (int) sizeof(name), \
1062 (wxObjectConstructorFn) wxConstructorFor##name , \
1063 name::GetPropertiesStatic(),name::sm_constructor##name , name::sm_constructorProperties##name , \
1064 name::sm_constructorPropertiesCount##name , wxVariantToObjectConverter##name , wxObjectToVariantConverter##name); \
1065 template<> void wxStringReadValue(const wxString & , name * & ){assert(0) ;}\
1066 template<> void wxStringWriteValue(wxString & , name* const & ){assert(0) ;}\
1067 template<> const wxTypeInfo* wxGetTypeInfo( name ** ){ static wxClassTypeInfo s_typeInfo(&name::sm_class##name) ; return &s_typeInfo ; }
1069 #define IMPLEMENT_DYNAMIC_CLASS2( name , basename , basename2) \
1070 _IMPLEMENT_DYNAMIC_CLASS2( name , basename , basename2 , "") \
1071 const wxPropertyInfo *name::GetPropertiesStatic() { return (wxPropertyInfo*) NULL ; } \
1072 WX_CONSTRUCTOR_DUMMY( name )
1074 #define IMPLEMENT_DYNAMIC_CLASS2_XTI( name , basename , basename2, unit) \
1075 _IMPLEMENT_DYNAMIC_CLASS2( name , basename , basename2 , unit)
1077 // -----------------------------------
1078 // for abstract classes
1079 // -----------------------------------
1081 // Single inheritance with one base class
1083 #define _IMPLEMENT_ABSTRACT_CLASS(name, basename) \
1084 const wxClassInfo* name::sm_classParents##name[] = { &basename::sm_class##basename ,NULL } ; \
1085 wxObject* wxVariantToObjectConverter##name ( const wxxVariant &data ) { return data.Get<name*>() ; } \
1086 wxxVariant wxObjectToVariantConverter##name ( wxObject *data ) { return wxxVariant( dynamic_cast<name*> (data) ) ; } \
1087 wxClassInfo name::sm_class##name(sm_classParents##name , wxT("") , wxT(#name), \
1088 (int) sizeof(name), \
1089 (wxObjectConstructorFn) 0 , \
1090 name::GetPropertiesStatic(),0 , 0 , \
1091 0 , wxVariantToObjectConverter##name , wxObjectToVariantConverter##name); \
1092 template<> void wxStringReadValue(const wxString & , name * & ){assert(0) ;}\
1093 template<> void wxStringWriteValue(wxString & , name* const & ){assert(0) ;}\
1094 template<> const wxTypeInfo* wxGetTypeInfo( name ** ){ static wxClassTypeInfo s_typeInfo(&name::sm_class##name) ; return &s_typeInfo ; }
1096 #define IMPLEMENT_ABSTRACT_CLASS( name , basename ) \
1097 _IMPLEMENT_ABSTRACT_CLASS( name , basename ) \
1098 const wxPropertyInfo *name::GetPropertiesStatic() { return (wxPropertyInfo*) NULL ; }
1100 // Multiple inheritance with two base classes
1102 #define IMPLEMENT_ABSTRACT_CLASS2(name, basename1, basename2) \
1103 wxClassInfo name::sm_class##name(wxT(#name), wxT(#basename1), \
1104 wxT(#basename2), (int) sizeof(name), \
1105 (wxObjectConstructorFn) 0);
1107 #define IMPLEMENT_CLASS IMPLEMENT_ABSTRACT_CLASS
1108 #define IMPLEMENT_CLASS2 IMPLEMENT_ABSTRACT_CLASS2