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(NO_GCC_PRAGMA)
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"
43 #include "wx/arrstr.h"
45 class WXDLLIMPEXP_BASE wxObject
;
46 class WXDLLIMPEXP_BASE wxClassInfo
;
47 class WXDLLIMPEXP_BASE wxHashTable
;
48 class WXDLLIMPEXP_BASE wxObjectRefData
;
49 class WXDLLIMPEXP_BASE wxEvent
;
51 typedef void (wxObject::*wxObjectEventFunction
)(wxEvent
&);
53 // ----------------------------------------------------------------------------
56 // In the header files there would no change from pure c++ code, in the
57 // implementation, an enum would have
58 // to be enumerated eg :
60 // WX_BEGIN_ENUM( wxFlavor )
61 // WX_ENUM_MEMBER( Vanilla )
62 // WX_ENUM_MEMBER( Chocolate )
63 // WX_ENUM_MEMBER( Strawberry )
64 // WX_END_ENUM( wxFlavor )
65 // ----------------------------------------------------------------------------
67 struct WXDLLIMPEXP_BASE wxEnumMemberData
73 class WXDLLIMPEXP_BASE wxEnumData
76 wxEnumData( wxEnumMemberData
* data
) ;
78 // returns true if the member has been found and sets the int value
79 // pointed to accordingly (if ptr != null )
80 // if not found returns false, value left unchanged
81 bool HasEnumMemberValue( const wxChar
*name
, int *value
= NULL
) ;
83 // returns the value of the member, if not found in debug mode an
84 // assert is issued, in release 0 is returned
85 int GetEnumMemberValue(const wxChar
*name
);
87 // returns the name of the enum member having the passed in value
88 // returns an emtpy string if not found
89 const wxChar
*GetEnumMemberName(int value
);
91 // returns the number of members in this enum
92 int GetEnumCount() { return m_count
; }
94 // returns the value of the nth member
95 int GetEnumMemberValueByIndex( int n
) ;
97 // returns the value of the nth member
98 const wxChar
*GetEnumMemberNameByIndex( int n
) ;
100 wxEnumMemberData
*m_members
;
104 #define WX_BEGIN_ENUM( e ) \
105 wxEnumMemberData s_enumDataMembers##e[] = {
107 #define WX_ENUM_MEMBER( v ) { #v, v } ,
109 #define WX_END_ENUM( e ) { NULL , 0 } } ; \
110 wxEnumData s_enumData##e( s_enumDataMembers##e ) ; \
111 wxEnumData *wxGetEnumData(e) { return &s_enumData##e ; } \
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) ; \
120 template<> const wxTypeInfo* wxGetTypeInfo( e * ){ static wxEnumTypeInfo s_typeInfo(wxT_ENUM , &s_enumData##e , &wxToStringConverter<e> , &wxFromStringConverter<e>) ; return &s_typeInfo ; } \
121 template<> const wxTypeInfo* wxGetTypeInfo( e ** ){ static wxBuiltInTypeInfo s_typeInfo(wxT_VOID ) ; assert(0) ; return &s_typeInfo ; } \
122 template<> void wxStringReadValue(const wxString& , e* & ) \
126 template<> void wxStringWriteValue(wxString &s , e* const & ) \
131 // ----------------------------------------------------------------------------
143 // typedef wxSet<wxFlavor> wxCoupe ;
145 // in the implementation file :
147 // WX_BEGIN_ENUM( wxFlavor )
148 // WX_ENUM_MEMBER( Vanilla )
149 // WX_ENUM_MEMBER( Chocolate )
150 // WX_ENUM_MEMBER( Strawberry )
151 // WX_END_ENUM( wxFlavor )
153 // WX_IMPLEMENT_SET_STREAMING( wxCoupe , wxFlavor )
155 // implementation note : no partial specialization for streaming, but a delegation to a
158 // ----------------------------------------------------------------------------
160 // in order to remove dependancy on string tokenizer
161 void wxSetStringToArray( const wxString
&s
, wxArrayString
&array
) ;
164 void wxSetFromString(const wxString
&s
, wxSet
<e
> &data
)
166 wxEnumData
* edata
= wxGetEnumData((e
) 0) ;
169 wxArrayString array
;
170 wxSetStringToArray( s
, array
) ;
172 for ( int i
= 0 ; i
< array
.Count() ; ++i
)
176 if ( edata
->HasEnumMemberValue( flag
, &ivalue
) )
178 data
.Set( (e
) ivalue
) ;
184 void wxSetToString( wxString
&s
, const wxSet
<e
> &data
)
186 wxEnumData
* edata
= wxGetEnumData((e
) 0) ;
187 int count
= edata
->GetEnumCount() ;
190 for ( i
= 0 ; i
< count
; i
++ )
192 e value
= (e
) edata
->GetEnumMemberValueByIndex(i
) ;
193 if ( data
.Contains( value
) )
195 // this could also be done by the templated calls
198 s
+= edata
->GetEnumMemberNameByIndex(i
) ;
203 // if the wxSet specialization above does not work for all compilers, add this to the WX_IMPLEMENT_SET_STREAMING macro
204 // template<> const wxTypeInfo* wxGetTypeInfo( SetName * ){ static wxEnumTypeInfo s_typeInfo(wxT_SET , &s_enumData##e) ; return &s_typeInfo ; }
206 #define WX_IMPLEMENT_SET_STREAMING(SetName,e) \
207 template<> void wxStringReadValue(const wxString &s , wxSet<e> &data ) \
209 wxSetFromString( s , data ) ; \
211 template<> void wxStringWriteValue( wxString &s , const wxSet<e> &data ) \
213 wxSetToString( s , data ) ; \
217 // ----------------------------------------------------------------------------
219 // ----------------------------------------------------------------------------
222 // All data exposed by the RTTI is characterized using the following classes.
223 // The first characterization is done by wxTypeKind. All enums up to and including
224 // wxT_CUSTOM represent so called simple types. These cannot be divided any further.
225 // They can be converted to and from wxStrings, that's all.
230 wxT_VOID
= 0, // unknown type
240 wxT_STRING
, // must be wxString
241 wxT_SET
, // must be wxSet<> template
243 wxT_CUSTOM
, // user defined type (e.g. wxPoint)
245 wxT_LAST_SIMPLE_TYPE_KIND
= wxT_CUSTOM
,
247 wxT_OBJECT_PTR
, // object reference
248 wxT_OBJECT
, // embedded object
249 wxT_COLLECTION
, // collection
251 wxT_DELEGATE
, // for connecting against an event source
253 wxT_LAST_TYPE_KIND
= wxT_DELEGATE
// sentinel for bad data, asserts, debugging
258 class WXDLLIMPEXP_BASE wxTypeInfo
261 wxTypeInfo() : m_kind( wxT_VOID
) , m_toString(NULL
) , m_fromString(NULL
) {}
262 virtual ~wxTypeInfo() {}
263 wxTypeKind
GetKind() const { return m_kind
; }
264 bool IsDelegateType() const { return m_kind
== wxT_DELEGATE
; }
265 bool IsCustomType() const { return m_kind
== wxT_CUSTOM
; }
266 bool IsObjectType() const { return m_kind
== wxT_OBJECT
|| m_kind
== wxT_OBJECT_PTR
; }
267 bool HasStringConverters() const { return m_toString
!= NULL
&& m_fromString
!= NULL
; }
268 void ConvertToString( const wxxVariant
& data
, wxString
&result
) const
269 { wxASSERT_MSG( m_toString
, wxT("String conversions not supported") ) ; (*m_toString
)( data
, result
) ; }
270 void ConvertFromString( const wxString
& data
, wxxVariant
&result
) const
271 { wxASSERT_MSG( m_fromString
, wxT("String conversions not supported") ) ; (*m_fromString
)( data
, result
) ; }
274 typedef void (*converterToString_t
)( const wxxVariant
& data
, wxString
&result
) ;
275 typedef void (*converterFromString_t
)( const wxString
& data
, wxxVariant
&result
) ;
277 converterToString_t m_toString
;
278 converterFromString_t m_fromString
;
283 class WXDLLIMPEXP_BASE wxBuiltInTypeInfo
: public wxTypeInfo
286 wxBuiltInTypeInfo( wxTypeKind kind
, converterToString_t to
= NULL
, converterFromString_t from
= NULL
)
287 { wxASSERT_MSG( kind
< wxT_SET
, wxT("Illegal Kind for Base Type") ) ; m_kind
= kind
; m_toString
= to
; m_fromString
= from
;}
290 class WXDLLIMPEXP_BASE wxCustomTypeInfo
: public wxTypeInfo
293 wxCustomTypeInfo( const wxChar
*typeName
, converterToString_t to
= NULL
, converterFromString_t from
= NULL
)
294 { m_kind
= wxT_CUSTOM
; m_typeName
= typeName
;m_toString
= to
; m_fromString
= from
;}
295 const wxChar
*GetTypeName() const { return m_typeName
; }
297 const wxChar
*m_typeName
; // Kind == wxT_CUSTOM
300 class WXDLLIMPEXP_BASE wxEnumTypeInfo
: public wxTypeInfo
303 wxEnumTypeInfo( wxTypeKind kind
, wxEnumData
* enumInfo
, converterToString_t to
= NULL
, converterFromString_t from
= NULL
)
304 { wxASSERT_MSG( kind
== wxT_ENUM
|| kind
== wxT_SET
, wxT("Illegal Kind for Enum Type")) ; m_kind
= kind
; m_enumInfo
= enumInfo
;m_toString
= to
; m_fromString
= from
;}
305 const wxEnumData
* GetEnumData() const { return m_enumInfo
; }
307 wxEnumData
*m_enumInfo
; // Kind == wxT_ENUM or Kind == wxT_SET
310 class WXDLLIMPEXP_BASE wxClassTypeInfo
: public wxTypeInfo
313 wxClassTypeInfo( wxTypeKind kind
, wxClassInfo
* classInfo
, converterToString_t to
= NULL
, converterFromString_t from
= NULL
)
314 { wxASSERT_MSG( kind
== wxT_OBJECT_PTR
|| kind
== wxT_OBJECT
, wxT("Illegal Kind for Enum Type")) ; m_kind
= kind
; m_classInfo
= classInfo
;}
315 const wxClassInfo
*GetClassInfo() const { return m_classInfo
; }
317 wxClassInfo
*m_classInfo
; // Kind == wxT_OBJECT - could be NULL
320 class WXDLLIMPEXP_BASE wxCollectionTypeInfo
: public wxTypeInfo
323 wxCollectionTypeInfo( wxTypeInfo
*elementType
, converterToString_t to
= NULL
, converterFromString_t from
= NULL
)
324 { m_kind
= wxT_COLLECTION
, m_elementType
= elementType
; m_toString
= to
; m_fromString
= from
;}
326 const wxTypeInfo
* GetElementType() const { return m_elementType
; }
328 wxTypeInfo
* m_elementType
;
331 // a delegate is an exposed event source
333 class WXDLLIMPEXP_BASE wxDelegateTypeInfo
: public wxTypeInfo
336 wxDelegateTypeInfo( int eventType
, wxClassInfo
* eventClass
, converterToString_t to
= NULL
, converterFromString_t from
= NULL
)
337 { m_kind
= wxT_DELEGATE
; m_eventClass
= eventClass
; m_eventType
= eventType
;m_toString
= to
; m_fromString
= from
;}
338 const wxClassInfo
*GetEventClass() const { assert( m_kind
== wxT_DELEGATE
) ; return m_eventClass
; }
339 int GetEventType() const { return m_eventType
; }
341 const wxClassInfo
*m_eventClass
; // (extended will merge into classinfo)
345 template<typename T
> const wxTypeInfo
* wxGetTypeInfo( T
* ) ;
347 template<typename T
> const wxTypeInfo
* wxGetTypeInfo( wxSet
<T
> * )
349 static wxEnumTypeInfo
s_typeInfo(wxT_SET
, wxGetEnumData((T
) 0) ) ; return &s_typeInfo
;
352 // this macro is for usage with custom, non-object derived classes and structs, wxPoint is such a custom type
354 #define WX_CUSTOM_TYPE_INFO( e ) \
355 template<> const wxTypeInfo* wxGetTypeInfo( e ** ){ static wxBuiltInTypeInfo s_typeInfo(wxT_VOID) ; assert(0) ; return &s_typeInfo ; } \
356 template<> const wxTypeInfo* wxGetTypeInfo( e * ){ static wxCustomTypeInfo s_typeInfo(#e, &wxToStringConverter<e> , &wxFromStringConverter<e>) ; return &s_typeInfo ; }
358 // templated streaming, every type must have their specialization for these methods
361 void wxStringReadValue( const wxString
&s
, T
&data
);
364 void wxStringWriteValue( wxString
&s
, const T
&data
);
367 void wxToStringConverter( const wxxVariant
&v
, wxString
&s
) { wxStringWriteValue( s
, v
.Get
<T
>() ) ; }
370 void wxFromStringConverter( const wxString
&s
, wxxVariant
&v
) { T d
; wxStringReadValue( s
, d
) ; v
= wxxVariant(d
) ; } \
372 // sometimes a compiler invents specializations that are nowhere called, use this macro to satisfy the refs
374 #define WX_ILLEGAL_TYPE_SPECIALIZATION( a ) \
375 template<> const wxTypeInfo* wxGetTypeInfo( a * ) { assert(0) ; \
376 static wxBuiltInTypeInfo s_typeInfo( wxT_VOID ) ; return &s_typeInfo ; } \
377 template<> void wxStringReadValue(const wxString & , a & ) { assert(0) ; }\
378 template<> void wxStringWriteValue(wxString & , a const & ) { assert(0) ; }
380 // ----------------------------------------------------------------------------
381 // wxxVariant as typesafe data holder
382 // ----------------------------------------------------------------------------
384 class WXDLLIMPEXP_BASE wxxVariantData
387 virtual ~wxxVariantData() {}
389 // return a heap allocated duplicate
390 virtual wxxVariantData
* Clone() const = 0 ;
392 // returns the type info of the contentc
393 virtual const wxTypeInfo
* GetTypeInfo() const = 0 ;
396 template<typename T
> class WXDLLIMPEXP_BASE wxxVariantDataT
: public wxxVariantData
399 wxxVariantDataT(const T
& d
) : m_data(d
) {}
400 virtual ~wxxVariantDataT() {}
402 // get a ref to the stored data
403 T
& Get() { return m_data
; }
405 // get a const ref to the stored data
406 const T
& Get() const { return m_data
; }
409 void Set(const T
& d
) { m_data
= d
; }
411 // return a heap allocated duplicate
412 virtual wxxVariantData
* Clone() const { return new wxxVariantDataT
<T
>( Get() ) ; }
414 // returns the type info of the contentc
415 virtual const wxTypeInfo
* GetTypeInfo() const { return wxGetTypeInfo( (T
*) NULL
) ; }
420 class WXDLLIMPEXP_BASE wxxVariant
423 wxxVariant() { m_data
= NULL
; }
424 wxxVariant( wxxVariantData
* data
, const wxString
& name
= wxT("") ) : m_data(data
) , m_name(name
) {}
425 wxxVariant( const wxxVariant
&d
) { if ( d
.m_data
) m_data
= d
.m_data
->Clone() ; else m_data
= NULL
; m_name
= d
.m_name
; }
427 template<typename T
> wxxVariant( T data
, const wxString
& name
= wxT("") ) :
428 m_data(new wxxVariantDataT
<T
>(data
) ), m_name(name
) {}
430 ~wxxVariant() { delete m_data
; }
432 // get a ref to the stored data
433 template<typename T
> T
& Get()
435 wxxVariantDataT
<T
> *dataptr
= dynamic_cast<wxxVariantDataT
<T
>*> (m_data
) ;
436 wxASSERT_MSG( dataptr
, "Cast not possible" ) ;
437 return dataptr
->Get() ;
440 // get a ref to the stored data
441 template<typename T
> const T
& Get() const
443 const wxxVariantDataT
<T
> *dataptr
= dynamic_cast<const wxxVariantDataT
<T
>*> (m_data
) ;
444 wxASSERT_MSG( dataptr
, "Cast not possible" ) ;
445 return dataptr
->Get() ;
448 template<typename T
> bool HasData() const
450 const wxxVariantDataT
<T
> *dataptr
= dynamic_cast<const wxxVariantDataT
<T
>*> (m_data
) ;
451 return dataptr
!= NULL
;
455 template<typename T
> void Set(const T
& data
) const
458 m_data
= new wxxVariantDataT
<T
>(data
) ;
461 wxxVariant
& operator=(const wxxVariant
&d
)
463 m_data
= d
.m_data
->Clone() ;
468 // gets the stored data casted to a wxObject* , returning NULL if cast is not possible
469 wxObject
* GetAsObject() ;
471 // get the typeinfo of the stored object
472 const wxTypeInfo
* GetTypeInfo() const { return m_data
->GetTypeInfo() ; }
474 // returns this value as string
475 wxString
GetAsString() const
478 GetTypeInfo()->ConvertToString( *this , s
) ;
482 wxxVariantData
* m_data
;
486 #include <wx/dynarray.h>
488 WX_DECLARE_OBJARRAY_WITH_DECL(wxxVariant
, wxxVariantArray
, class WXDLLIMPEXP_BASE
);
490 // ----------------------------------------------------------------------------
493 // wxPropertyInfo is used to inquire of the property by name. It doesn't
494 // provide access to the property, only information about it. If you
495 // want access, look at wxPropertyAccessor.
496 // ----------------------------------------------------------------------------
501 wxSetter( const wxString name
) { m_name
= name
; }
502 virtual void Set( wxObject
*object
, const wxxVariant
&variantValue
) const = 0;
503 const wxString
& GetName() const { return m_name
; }
511 wxGetter( const wxString name
) { m_name
= name
; }
512 virtual void Get( const wxObject
*object
, wxxVariant
& result
) const = 0;
513 const wxString
& GetName() const { return m_name
; }
518 class wxCollectionGetter
521 wxCollectionGetter( const wxString name
) { m_name
= name
; }
522 virtual void Get( const wxObject
*object
, wxxVariantArray
& result
) const = 0;
523 const wxString
& GetName() const { return m_name
; }
528 template<typename coll_t
> void wxCollectionToVariantArray( const coll_t
& coll
, wxxVariantArray
& result
) ;
533 wxAdder( const wxString name
) { m_name
= name
; }
534 virtual void Add( wxObject
*object
, const wxxVariant
&variantValue
) const= 0;
535 const wxString
& GetName() const { return m_name
; }
542 #define WX_SETTER( property, Klass, valueType, setterMethod ) \
543 class wxSetter##property : public wxSetter \
546 wxSetter##property() : wxSetter( #setterMethod ) {} \
547 void Set( wxObject *object, const wxxVariant &variantValue ) const \
549 Klass *obj = dynamic_cast<Klass*>(object) ; \
550 if ( variantValue.HasData<valueType>() ) \
551 obj->setterMethod(variantValue.Get<valueType>()) ; \
553 obj->setterMethod(*variantValue.Get<valueType*>()) ; \
557 #define WX_GETTER( property, Klass, valueType , gettermethod ) \
558 class wxGetter##property : public wxGetter \
561 wxGetter##property() : wxGetter( #gettermethod ) {} \
562 void Get( const wxObject *object , wxxVariant &result) const \
564 const Klass *obj = dynamic_cast<const Klass*>(object) ; \
565 result = wxxVariant( obj->gettermethod() ) ; \
569 #define WX_ADDER( property, Klass, valueType , addermethod ) \
570 class wxAdder##property : public wxAdder \
573 wxAdder##property() : wxAdder( #addermethod ) {} \
574 void Add( wxObject *object, const wxxVariant &variantValue ) const \
576 Klass *obj = dynamic_cast<Klass*>(object) ; \
577 if ( variantValue.HasData<valueType>() ) \
578 obj->addermethod(variantValue.Get<valueType>()) ; \
580 obj->addermethod(*variantValue.Get<valueType*>()) ; \
584 #define WX_COLLECTION_GETTER( property, Klass, valueType , gettermethod ) \
585 class wxCollectionGetter##property : public wxCollectionGetter \
588 wxCollectionGetter##property() : wxCollectionGetter( #gettermethod ) {} \
589 void Get( const wxObject *object , wxxVariantArray &result) const \
591 const Klass *obj = dynamic_cast<const Klass*>(object) ; \
592 wxCollectionToVariantArray( obj->gettermethod() , result ) ; \
596 class WXDLLIMPEXP_BASE wxPropertyAccessor
599 wxPropertyAccessor( wxSetter
*setter
, wxGetter
*getter
, wxAdder
*adder
, wxCollectionGetter
*collectionGetter
)
600 { m_setter
= setter
; m_getter
= getter
; m_adder
= adder
; m_collectionGetter
= collectionGetter
;}
602 virtual ~wxPropertyAccessor() {}
604 // Setting a simple property (non-collection)
605 virtual void SetProperty(wxObject
*object
, const wxxVariant
&value
) const
606 { wxASSERT_MSG(m_setter
,wxT("SetProperty called w/o valid setter") ) ; m_setter
->Set( object
, value
) ;}
608 // Getting a simple property (non-collection)
609 virtual void GetProperty(const wxObject
*object
, wxxVariant
&result
) const
610 { wxASSERT_MSG(m_getter
,wxT("GetProperty called w/o valid getter") ) ; return m_getter
->Get( object
, result
) ;}
612 // Adding an element to a collection property
613 virtual void AddToPropertyCollection(wxObject
*object
, const wxxVariant
&value
) const
614 { wxASSERT_MSG(m_adder
,wxT("AddToPropertyCollection called w/o valid adder") ) ; m_adder
->Add( object
, value
) ;}
616 // Getting a collection property
617 virtual void GetPropertyCollection( const wxObject
*obj
, wxxVariantArray
&result
) const
618 { wxASSERT_MSG(m_collectionGetter
,wxT("GetPropertyCollection called w/o valid collection getter") ) ; return m_collectionGetter
->Get( obj
, result
) ;}
620 virtual bool HasSetter() const { return m_setter
!= NULL
; }
621 virtual bool HasCollectionGetter() const { return m_collectionGetter
!= NULL
; }
622 virtual bool HasGetter() const { return m_getter
!= NULL
; }
623 virtual bool HasAdder() const { return m_adder
!= NULL
; }
625 virtual const wxString
& GetCollectionGetterName() const
626 { return m_collectionGetter
->GetName() ; }
627 virtual const wxString
& GetGetterName() const
628 { return m_getter
->GetName() ; }
629 virtual const wxString
& GetSetterName() const
630 { return m_setter
->GetName() ; }
631 virtual const wxString
& GetAdderName() const
632 { return m_adder
->GetName() ; }
634 virtual wxxVariant ReadValue( const wxString &value ) const ;
635 virtual void WriteValue( wxString& value , const wxObject *o ) const ;
641 wxCollectionGetter
* m_collectionGetter
;
644 class WXDLLIMPEXP_BASE wxGenericPropertyAccessor
: public wxPropertyAccessor
647 wxGenericPropertyAccessor( const wxString
&propName
) ;
648 ~wxGenericPropertyAccessor() ;
650 virtual bool HasSetter() const { return true ; }
651 virtual bool HasGetter() const { return true ; }
652 virtual bool HasAdder() const { return false ; }
653 virtual bool HasCollectionGetter() const { return false ; }
655 virtual const wxString
& GetGetterName() const
656 { return m_getterName
; }
657 virtual const wxString
& GetSetterName() const
658 { return m_setterName
; }
660 virtual void SetProperty(wxObject
*object
, const wxxVariant
&value
) const ;
661 virtual void GetProperty(const wxObject
*object
, wxxVariant
&value
) const ;
663 // Adding an element to a collection property
664 virtual void AddToPropertyCollection(wxObject
*object
, const wxxVariant
&value
) const
665 { wxASSERT_MSG(0,wxT("AddToPropertyCollection called on a generic accessor") ) ;}
667 // Getting a collection property
668 virtual void GetPropertyCollection( const wxObject
*obj
, wxxVariantArray
&result
) const
669 { wxASSERT_MSG(0,wxT("GetPropertyCollection called on a generic accessor") ) ;}
671 struct wxGenericPropertyAccessorInternal
;
672 wxGenericPropertyAccessorInternal
* m_data
;
673 wxString m_propertyName
;
674 wxString m_setterName
;
675 wxString m_getterName
;
678 class WXDLLIMPEXP_BASE wxPropertyInfo
681 wxPropertyInfo( wxPropertyInfo
* &iter
, const wxChar
*name
, const wxTypeInfo
* typeInfo
, wxPropertyAccessor
*accessor
, wxxVariant dv
) :
682 m_name( name
) , m_typeInfo( typeInfo
) , m_accessor( accessor
) , m_defaultValue( dv
) , m_collectionElementTypeInfo(NULL
)
687 wxPropertyInfo( wxPropertyInfo
* &iter
, const wxChar
*name
, const wxTypeInfo
* collTypeInfo
, const wxTypeInfo
* elemTypeInfo
, wxPropertyAccessor
*accessor
) :
688 m_name( name
) , m_typeInfo( collTypeInfo
) , m_accessor( accessor
) , m_collectionElementTypeInfo(elemTypeInfo
)
693 // return the name of this property
694 const wxChar
* GetName() const { return m_name
; }
696 // return the element type info of this property (for collections, otherwise NULL)
697 const wxTypeInfo
* GetCollectionElementTypeInfo() const { return m_collectionElementTypeInfo
; }
699 // return the type info of this property
700 const wxTypeInfo
* GetTypeInfo() const { return m_typeInfo
; }
702 // return the accessor for this property
703 wxPropertyAccessor
* GetAccessor() const { return m_accessor
; }
705 // returns NULL if this is the last property of this class
706 wxPropertyInfo
* GetNext() const { return m_next
; }
708 // returns the default value of this property, its kind may be wxT_VOID if it is not valid
709 wxxVariant
GetDefaultValue() const { return m_defaultValue
; }
711 void Insert(wxPropertyInfo
* &iter
)
718 wxPropertyInfo
* i
= iter
;
726 const wxChar
* m_name
;
727 const wxChar
* m_typeName
;
728 const wxTypeInfo
* m_typeInfo
;
729 const wxTypeInfo
* m_collectionElementTypeInfo
;
730 wxPropertyAccessor
* m_accessor
;
731 wxxVariant m_defaultValue
;
732 // string representation of the default value
733 // to be assigned by the designer to the property
734 // when the component is dropped on the container.
735 wxPropertyInfo
* m_next
;
738 #define WX_BEGIN_PROPERTIES_TABLE(theClass) \
739 wxPropertyInfo *theClass::GetPropertiesStatic() \
741 typedef theClass class_t; \
742 static wxPropertyInfo* first = NULL ;
744 #define WX_END_PROPERTIES_TABLE() \
749 #define WX_PROPERTY( name , type , setter , getter ,defaultValue ) \
750 WX_SETTER( name , class_t , type , setter ) \
751 static wxSetter##name _setter##name ; \
752 WX_GETTER( name , class_t , type , getter ) \
753 static wxGetter##name _getter##name ; \
754 static wxPropertyAccessor _accessor##name( &_setter##name , &_getter##name , NULL , NULL ) ; \
755 static wxPropertyInfo _propertyInfo##name( first , #name , wxGetTypeInfo( (type*) NULL ) ,&_accessor##name , wxxVariant(defaultValue) ) ;
757 #define WX_READONLY_PROPERTY( name , type , getter ,defaultValue ) \
758 WX_GETTER( name , class_t , type , getter ) \
759 static wxGetter##name _getter##name ; \
760 static wxPropertyAccessor _accessor##name( NULL , &_getter##name , NULL , NULL ) ; \
761 static wxPropertyInfo _propertyInfo##name( first , #name , wxGetTypeInfo( (type*) NULL ) ,&_accessor##name , wxxVariant(defaultValue) ) ;
763 #define WX_PROPERTY_COLLECTION( name , colltype , addelemtype , adder , getter ) \
764 WX_ADDER( name , class_t , addelemtype , adder ) \
765 static wxAdder##name _adder##name ; \
766 WX_COLLECTION_GETTER( name , class_t , colltype , getter ) \
767 static wxCollectionGetter##name _collectionGetter##name ; \
768 static wxPropertyAccessor _accessor##name( NULL , NULL ,&_adder##name , &_collectionGetter##name ) ; \
769 static wxPropertyInfo _propertyInfo##name( first , #name , wxGetTypeInfo( (colltype*) NULL ) ,wxGetTypeInfo( (addelemtype*) NULL ) ,&_accessor##name ) ;
771 #define WX_READONLY_PROPERTY_COLLECTION( name , colltype , addelemtype , getter ) \
772 WX_COLLECTION_GETTER( name , class_t , colltype , getter ) \
773 static wxCollectionGetter##name _collectionGetter##name ; \
774 static wxPropertyAccessor _accessor##name( NULL , NULL , NULL , &_collectionGetter##name ) ; \
775 static wxPropertyInfo _propertyInfo##name( first , #name , wxGetTypeInfo( (colltype*) NULL ) ,wxGetTypeInfo( (addelemtype*) NULL ) ,&_accessor##name ) ;
777 #define WX_PROPERTY_COLLECTION( name , colltype , addelemtype , adder , getter ) \
778 static wxPropertyCollectionAccessorT<class_t , colltype , addelemtype > _accessor##name( &adder , &getter , #adder , #getter ) ; \
779 static wxPropertyInfo _propertyInfo##name( first , #name , wxGetTypeInfo( (colltype*) NULL ) ,wxGetTypeInfo( (addelemtype*) NULL ) ,&_accessor##name ) ;
781 #define WX_READONLY_PROPERTY_COLLECTION( name , colltype , addelemtype , getter ) \
782 static wxPropertyCollectionAccessorT<class_t , colltype , addelemtype > _accessor##name( &getter , #getter ) ; \
783 static wxPropertyInfo _propertyInfo##name( first , #name , wxGetTypeInfo( (colltype*) NULL ) ,wxGetTypeInfo( (addelemtype*) NULL ) ,&_accessor##name ) ;
788 #define WX_DELEGATE( name , eventType , eventClass ) \
789 static wxDelegateTypeInfo _typeInfo##name( eventType , CLASSINFO( eventClass ) ) ; \
790 static wxPropertyInfo _propertyInfo##name( first , #name , &_typeInfo##name , NULL , wxxVariant() ) ; \
792 // ----------------------------------------------------------------------------
795 // this is describing an event sink
796 // ----------------------------------------------------------------------------
801 wxHandlerInfo( wxHandlerInfo
* &iter
, const wxChar
*name
, wxObjectEventFunction address
, const wxClassInfo
* eventClassInfo
) :
802 m_name( name
) , m_eventClassInfo( eventClassInfo
) , m_eventFunction( address
)
809 wxHandlerInfo
* i
= iter
;
817 // get the name of the handler method
818 const wxChar
* GetName() const { return m_name
; }
820 // return the class info of the event
821 const wxClassInfo
* GetEventClassInfo() const { return m_eventClassInfo
; }
823 // get the handler function pointer
824 wxObjectEventFunction
GetEventFunction() const { return m_eventFunction
; }
826 // returns NULL if this is the last handler of this class
827 wxHandlerInfo
* GetNext() const { return m_next
; }
829 wxObjectEventFunction m_eventFunction
;
830 const wxChar
* m_name
;
831 const wxClassInfo
* m_eventClassInfo
;
832 wxHandlerInfo
* m_next
;
835 #define WX_HANDLER(name,eventClassType) \
836 static wxHandlerInfo _handlerInfo##name( first , #name , (wxObjectEventFunction) (wxEventFunction) &name , CLASSINFO( eventClassType ) ) ;
838 #define WX_BEGIN_HANDLERS_TABLE(theClass) \
839 wxHandlerInfo *theClass::GetHandlersStatic() \
841 typedef theClass class_t; \
842 static wxHandlerInfo* first = NULL ;
844 #define WX_END_HANDLERS_TABLE() \
847 // ----------------------------------------------------------------------------
848 // Constructor Bridges
850 // allow to set up constructors with params during runtime
851 // ----------------------------------------------------------------------------
853 class WXDLLIMPEXP_BASE wxConstructorBridge
856 virtual void Create(wxObject
*o
, wxxVariant
*args
) = 0;
859 // Creator Bridges for all Numbers of Params
863 template<typename Class
>
864 struct wxConstructorBridge_0
: public wxConstructorBridge
866 void Create(wxObject
*o
, wxxVariant
*)
868 Class
*obj
= dynamic_cast<Class
*>(o
);
873 struct wxConstructorBridge_Dummy
: public wxConstructorBridge
875 void Create(wxObject
*, wxxVariant
*)
880 #define WX_CONSTRUCTOR_0(klass) \
881 wxConstructorBridge_0<klass> constructor##klass ; \
882 wxConstructorBridge* klass::sm_constructor##klass = &constructor##klass ; \
883 const wxChar *klass::sm_constructorProperties##klass[] = { NULL } ; \
884 const int klass::sm_constructorPropertiesCount##klass = 0 ;
886 #define WX_CONSTRUCTOR_DUMMY(klass) \
887 wxConstructorBridge_Dummy constructor##klass ; \
888 wxConstructorBridge* klass::sm_constructor##klass = &constructor##klass ; \
889 const wxChar *klass::sm_constructorProperties##klass[] = { NULL } ; \
890 const int klass::sm_constructorPropertiesCount##klass = 0 ;
894 template<typename Class
, typename T0
>
895 struct wxConstructorBridge_1
: public wxConstructorBridge
897 void Create(wxObject
*o
, wxxVariant
*args
)
899 Class
*obj
= dynamic_cast<Class
*>(o
);
906 #define WX_CONSTRUCTOR_1(klass,t0,v0) \
907 wxConstructorBridge_1<klass,t0> constructor##klass ; \
908 wxConstructorBridge* klass::sm_constructor##klass = &constructor##klass ; \
909 const wxChar *klass::sm_constructorProperties##klass[] = { #v0 } ; \
910 const int klass::sm_constructorPropertiesCount##klass = 1 ;
914 template<typename Class
,
915 typename T0
, typename T1
>
916 struct wxConstructorBridge_2
: public wxConstructorBridge
918 void Create(wxObject
*o
, wxxVariant
*args
)
920 Class
*obj
= dynamic_cast<Class
*>(o
);
928 #define WX_CONSTRUCTOR_2(klass,t0,v0,t1,v1) \
929 wxConstructorBridge_2<klass,t0,t1> constructor##klass ; \
930 wxConstructorBridge* klass::sm_constructor##klass = &constructor##klass ; \
931 const wxChar *klass::sm_constructorProperties##klass[] = { #v0 , #v1 } ; \
932 const int klass::sm_constructorPropertiesCount##klass = 2;
936 template<typename Class
,
937 typename T0
, typename T1
, typename T2
>
938 struct wxConstructorBridge_3
: public wxConstructorBridge
940 void Create(wxObject
*o
, wxxVariant
*args
)
942 Class
*obj
= dynamic_cast<Class
*>(o
);
951 #define WX_CONSTRUCTOR_3(klass,t0,v0,t1,v1,t2,v2) \
952 wxConstructorBridge_3<klass,t0,t1,t2> constructor##klass ; \
953 wxConstructorBridge* klass::sm_constructor##klass = &constructor##klass ; \
954 const wxChar *klass::sm_constructorProperties##klass[] = { #v0 , #v1 , #v2 } ; \
955 const int klass::sm_constructorPropertiesCount##klass = 3 ;
959 template<typename Class
,
960 typename T0
, typename T1
, typename T2
, typename T3
>
961 struct wxConstructorBridge_4
: public wxConstructorBridge
963 void Create(wxObject
*o
, wxxVariant
*args
)
965 Class
*obj
= dynamic_cast<Class
*>(o
);
975 #define WX_CONSTRUCTOR_4(klass,t0,v0,t1,v1,t2,v2,t3,v3) \
976 wxConstructorBridge_4<klass,t0,t1,t2,t3> constructor##klass ; \
977 wxConstructorBridge* klass::sm_constructor##klass = &constructor##klass ; \
978 const wxChar *klass::sm_constructorProperties##klass[] = { #v0 , #v1 , #v2 , #v3 } ; \
979 const int klass::sm_constructorPropertiesCount##klass = 4 ;
983 template<typename Class
,
984 typename T0
, typename T1
, typename T2
, typename T3
, typename T4
>
985 struct wxConstructorBridge_5
: public wxConstructorBridge
987 void Create(wxObject
*o
, wxxVariant
*args
)
989 Class
*obj
= dynamic_cast<Class
*>(o
);
1000 #define WX_CONSTRUCTOR_5(klass,t0,v0,t1,v1,t2,v2,t3,v3,t4,v4) \
1001 wxConstructorBridge_5<klass,t0,t1,t2,t3,t4> constructor##klass ; \
1002 wxConstructorBridge* klass::sm_constructor##klass = &constructor##klass ; \
1003 const wxChar *klass::sm_constructorProperties##klass[] = { #v0 , #v1 , #v2 , #v3 , #v4 } ; \
1004 const int klass::sm_constructorPropertiesCount##klass = 5;
1008 template<typename Class
,
1009 typename T0
, typename T1
, typename T2
, typename T3
, typename T4
, typename T5
>
1010 struct wxConstructorBridge_6
: public wxConstructorBridge
1012 void Create(wxObject
*o
, wxxVariant
*args
)
1014 Class
*obj
= dynamic_cast<Class
*>(o
);
1026 #define WX_CONSTRUCTOR_6(klass,t0,v0,t1,v1,t2,v2,t3,v3,t4,v4,t5,v5) \
1027 wxConstructorBridge_6<klass,t0,t1,t2,t3,t4,t5> constructor##klass ; \
1028 wxConstructorBridge* klass::sm_constructor##klass = &constructor##klass ; \
1029 const wxChar *klass::sm_constructorProperties##klass[] = { #v0 , #v1 , #v2 , #v3 , #v4 , #v5 } ; \
1030 const int klass::sm_constructorPropertiesCount##klass = 6;
1034 template<typename Class
,
1035 typename T0
, typename T1
, typename T2
, typename T3
, typename T4
, typename T5
, typename T6
>
1036 struct wxConstructorBridge_7
: public wxConstructorBridge
1038 void Create(wxObject
*o
, wxxVariant
*args
)
1040 Class
*obj
= dynamic_cast<Class
*>(o
);
1053 #define WX_CONSTRUCTOR_7(klass,t0,v0,t1,v1,t2,v2,t3,v3,t4,v4,t5,v5,t6,v6) \
1054 wxConstructorBridge_7<klass,t0,t1,t2,t3,t4,t5,t6> constructor##klass ; \
1055 wxConstructorBridge* klass::sm_constructor##klass = &constructor##klass ; \
1056 const wxChar *klass::sm_constructorProperties##klass[] = { #v0 , #v1 , #v2 , #v3 , #v4 , #v5 , #v6} ; \
1057 const int klass::sm_constructorPropertiesCount##klass = 7;
1061 template<typename Class
,
1062 typename T0
, typename T1
, typename T2
, typename T3
, typename T4
, typename T5
, typename T6
, typename T7
>
1063 struct wxConstructorBridge_8
: public wxConstructorBridge
1065 void Create(wxObject
*o
, wxxVariant
*args
)
1067 Class
*obj
= dynamic_cast<Class
*>(o
);
1081 #define WX_CONSTRUCTOR_8(klass,t0,v0,t1,v1,t2,v2,t3,v3,t4,v4,t5,v5,t6,v6,t7,v7) \
1082 wxConstructorBridge_8<klass,t0,t1,t2,t3,t4,t5,t6,t7> constructor##klass ; \
1083 wxConstructorBridge* klass::sm_constructor##klass = &constructor##klass ; \
1084 const wxChar *klass::sm_constructorProperties##klass[] = { #v0 , #v1 , #v2 , #v3 , #v4 , #v5 , #v6 , #v7} ; \
1085 const int klass::sm_constructorPropertiesCount##klass = 8;
1086 // ----------------------------------------------------------------------------
1088 // ----------------------------------------------------------------------------
1090 typedef wxObject
*(*wxObjectConstructorFn
)(void);
1091 typedef wxObject
* (*wxVariantToObjectConverter
)( wxxVariant
&data
) ;
1092 typedef wxxVariant (*wxObjectToVariantConverter
)( wxObject
* ) ;
1094 class WXDLLIMPEXP_BASE wxClassInfo
1097 wxClassInfo(const wxClassInfo
**_Parents
,
1098 const wxChar
*_UnitName
,
1099 const wxChar
*_ClassName
,
1101 wxObjectConstructorFn ctor
,
1102 wxPropertyInfo
*_Props
,
1103 wxHandlerInfo
*_Handlers
,
1104 wxConstructorBridge
* _Constructor
,
1105 const wxChar
** _ConstructorProperties
,
1106 const int _ConstructorPropertiesCount
,
1107 wxVariantToObjectConverter _PtrConverter1
,
1108 wxVariantToObjectConverter _Converter2
,
1109 wxObjectToVariantConverter _Converter3
1110 ) : m_parents(_Parents
) , m_unitName(_UnitName
) ,m_className(_ClassName
),
1111 m_objectSize(size
), m_objectConstructor(ctor
) , m_firstProperty(_Props
) , m_firstHandler(_Handlers
) , m_constructor( _Constructor
) ,
1112 m_constructorProperties(_ConstructorProperties
) , m_constructorPropertiesCount(_ConstructorPropertiesCount
),
1113 m_variantOfPtrToObjectConverter( _PtrConverter1
) , m_variantToObjectConverter( _Converter2
) , m_objectToVariantConverter( _Converter3
) , m_next(sm_first
)
1119 wxClassInfo(const wxChar
*_UnitName
, const wxChar
*_ClassName
, const wxClassInfo
**_Parents
) : m_parents(_Parents
) , m_unitName(_UnitName
) ,m_className(_ClassName
),
1120 m_objectSize(0), m_objectConstructor(NULL
) , m_firstProperty(NULL
) , m_firstHandler(NULL
) , m_constructor( NULL
) ,
1121 m_constructorProperties(NULL
) , m_constructorPropertiesCount(NULL
),
1122 m_variantOfPtrToObjectConverter( NULL
) , m_variantToObjectConverter( NULL
) , m_objectToVariantConverter( NULL
) , m_next(sm_first
)
1128 virtual ~wxClassInfo() ;
1130 // allocates an instance of this class, this object does not have to be initialized or fully constructed
1131 // as this call will be followed by a call to Create
1132 virtual wxObject
*AllocateObject() const { return m_objectConstructor
? (*m_objectConstructor
)() : 0; }
1134 // 'old naming' for AllocateObject staying here for backward compatibility
1135 wxObject
*CreateObject() const { return AllocateObject() ; }
1137 const wxChar
*GetClassName() const { return m_className
; }
1138 const wxClassInfo
**GetParents() const { return m_parents
; }
1139 int GetSize() const { return m_objectSize
; }
1141 wxObjectConstructorFn
GetConstructor() const { return m_objectConstructor
; }
1142 static const wxClassInfo
*GetFirst() { return sm_first
; }
1143 const wxClassInfo
*GetNext() const { return m_next
; }
1144 static wxClassInfo
*FindClass(const wxChar
*className
);
1146 // Climb upwards through inheritance hierarchy.
1147 // Dual inheritance is catered for.
1149 bool IsKindOf(const wxClassInfo
*info
) const
1156 for ( int i
= 0 ; m_parents
[i
] ; ++ i
)
1158 if ( m_parents
[i
]->IsKindOf( info
) )
1165 #ifdef WXWIN_COMPATIBILITY_2_4
1166 // Initializes parent pointers and hash table for fast searching.
1167 wxDEPRECATED( static void InitializeClasses() );
1168 // Cleans up hash table used for fast searching.
1169 wxDEPRECATED( static void CleanUpClasses() );
1171 static void CleanUp();
1173 // returns the first property
1174 const wxPropertyInfo
* GetFirstProperty() const { return m_firstProperty
; }
1176 // returns the first handler
1177 const wxHandlerInfo
* GetFirstHandler() const { return m_firstHandler
; }
1179 // Call the Create upon an instance of the class, in the end the object is fully
1181 virtual void Create (wxObject
*object
, int ParamCount
, wxxVariant
*Params
) const
1183 wxASSERT_MSG( ParamCount
== m_constructorPropertiesCount
, wxT("Illegal Parameter Count for Create Method")) ;
1184 m_constructor
->Create( object
, Params
) ;
1187 // get number of parameters for constructor
1188 virtual int GetCreateParamCount() const { return m_constructorPropertiesCount
; }
1190 // get n-th constructor parameter
1191 virtual const wxChar
* GetCreateParamName(int n
) const { return m_constructorProperties
[n
] ; }
1193 // Runtime access to objects for simple properties (get/set) by property name, and variant data
1194 virtual void SetProperty (wxObject
*object
, const wxChar
*propertyName
, const wxxVariant
&value
) const ;
1195 virtual wxxVariant
GetProperty (wxObject
*object
, const wxChar
*propertyName
) const;
1197 // Runtime access to objects for collection properties by property name
1198 virtual wxxVariantArray
GetPropertyCollection(wxObject
*object
, const wxChar
*propertyName
) const ;
1199 virtual void AddToPropertyCollection(wxObject
*object
, const wxChar
*propertyName
, const wxxVariant
& value
) const ;
1201 // we must be able to cast variants to wxObject pointers, templates seem not to be suitable
1202 wxObject
* VariantToInstance( wxxVariant
&data
) const
1203 { if ( data
.GetTypeInfo()->GetKind() == wxT_OBJECT
)
1204 return m_variantToObjectConverter( data
) ;
1206 return m_variantOfPtrToObjectConverter( data
) ;
1209 wxxVariant
InstanceToVariant( wxObject
*object
) const { return m_objectToVariantConverter( object
) ; }
1211 // find property by name
1212 virtual const wxPropertyInfo
*FindPropertyInfo (const wxChar
*PropertyName
) const ;
1214 // find handler by name
1215 virtual const wxHandlerInfo
*FindHandlerInfo (const wxChar
*PropertyName
) const ;
1217 // find property by name
1218 virtual const wxPropertyInfo
*FindPropertyInfoInThisClass (const wxChar
*PropertyName
) const ;
1220 // find handler by name
1221 virtual const wxHandlerInfo
*FindHandlerInfoInThisClass (const wxChar
*PropertyName
) const ;
1223 const wxChar
*m_className
;
1225 wxObjectConstructorFn m_objectConstructor
;
1227 // class info object live in a linked list:
1228 // pointers to its head and the next element in it
1230 static wxClassInfo
*sm_first
;
1231 wxClassInfo
*m_next
;
1233 // FIXME: this should be private (currently used directly by way too
1235 static wxHashTable
*sm_classTable
;
1238 wxPropertyInfo
* m_firstProperty
;
1239 wxHandlerInfo
* m_firstHandler
;
1241 const wxClassInfo
** m_parents
;
1242 const wxChar
* m_unitName
;
1244 wxConstructorBridge
* m_constructor
;
1245 const wxChar
** m_constructorProperties
;
1246 const int m_constructorPropertiesCount
;
1247 wxVariantToObjectConverter m_variantOfPtrToObjectConverter
;
1248 wxVariantToObjectConverter m_variantToObjectConverter
;
1249 wxObjectToVariantConverter m_objectToVariantConverter
;
1251 const wxPropertyAccessor
*FindAccessor (const wxChar
*propertyName
) const ;
1254 // InitializeClasses() helper
1255 static wxClassInfo
*GetBaseByName(const wxChar
*name
) ;
1258 // registers the class
1262 DECLARE_NO_COPY_CLASS(wxClassInfo
)
1266 WXDLLIMPEXP_BASE wxObject
*wxCreateDynamicObject(const wxChar
*name
);
1268 // ----------------------------------------------------------------------------
1270 // ----------------------------------------------------------------------------
1272 // this object leads to having a pure runtime-instantiation
1274 class wxDynamicClassInfo
: public wxClassInfo
1277 wxDynamicClassInfo( const wxChar
*_UnitName
, const wxChar
*_ClassName
, const wxClassInfo
* superClass
) ;
1278 virtual ~wxDynamicClassInfo() ;
1280 // constructs a wxDynamicObject with an instance
1281 virtual wxObject
*AllocateObject() const ;
1283 // Call the Create method for a class
1284 virtual void Create (wxObject
*object
, int ParamCount
, wxxVariant
*Params
) const ;
1286 // get number of parameters for constructor
1287 virtual int GetCreateParamCount() const ;
1289 // get i-th constructor parameter
1290 virtual const wxChar
* GetCreateParamName(int i
) const ;
1292 // Runtime access to objects by property name, and variant data
1293 virtual void SetProperty (wxObject
*object
, const wxChar
*PropertyName
, const wxxVariant
&Value
) const ;
1294 virtual wxxVariant
GetProperty (wxObject
*object
, const wxChar
*PropertyName
) const ;
1296 void AddProperty( const wxChar
*propertyName
, const wxTypeInfo
* typeInfo
) ;
1297 void AddHandler( const wxChar
*handlerName
, wxObjectEventFunction address
, const wxClassInfo
* eventClassInfo
) ;
1300 // ----------------------------------------------------------------------------
1301 // Dynamic class macros
1302 // ----------------------------------------------------------------------------
1304 #define _DECLARE_DYNAMIC_CLASS(name) \
1306 static wxClassInfo sm_class##name; \
1307 static const wxClassInfo* sm_classParents##name[] ; \
1308 static wxPropertyInfo* GetPropertiesStatic() ; \
1309 static wxHandlerInfo* GetHandlersStatic() ; \
1310 virtual wxClassInfo *GetClassInfo() const \
1311 { return &name::sm_class##name; }
1313 #define DECLARE_DYNAMIC_CLASS(name) \
1314 static wxConstructorBridge* sm_constructor##name ; \
1315 static const wxChar * sm_constructorProperties##name[] ; \
1316 static const int sm_constructorPropertiesCount##name ; \
1317 _DECLARE_DYNAMIC_CLASS(name)
1319 #define DECLARE_DYNAMIC_CLASS_NO_ASSIGN(name) \
1320 DECLARE_NO_ASSIGN_CLASS(name) \
1321 DECLARE_DYNAMIC_CLASS(name)
1323 #define DECLARE_DYNAMIC_CLASS_NO_COPY(name) \
1324 DECLARE_NO_COPY_CLASS(name) \
1325 DECLARE_DYNAMIC_CLASS(name)
1327 #define DECLARE_ABSTRACT_CLASS(name) _DECLARE_DYNAMIC_CLASS(name)
1328 #define DECLARE_CLASS(name) DECLARE_DYNAMIC_CLASS(name)
1330 // -----------------------------------
1331 // for concrete classes
1332 // -----------------------------------
1334 // Single inheritance with one base class
1336 #define _IMPLEMENT_DYNAMIC_CLASS(name, basename, unit) \
1337 wxObject* wxConstructorFor##name() \
1338 { return new name; } \
1339 const wxClassInfo* name::sm_classParents##name[] = { &basename::sm_class##basename ,NULL } ; \
1340 wxObject* wxVariantOfPtrToObjectConverter##name ( wxxVariant &data ) { return data.Get<name*>() ; } \
1341 wxxVariant wxObjectToVariantConverter##name ( wxObject *data ) { return wxxVariant( dynamic_cast<name*> (data) ) ; } \
1342 wxClassInfo name::sm_class##name(sm_classParents##name , wxT(unit) , wxT(#name), \
1343 (int) sizeof(name), \
1344 (wxObjectConstructorFn) wxConstructorFor##name , \
1345 name::GetPropertiesStatic(),name::GetHandlersStatic(),name::sm_constructor##name , name::sm_constructorProperties##name , \
1346 name::sm_constructorPropertiesCount##name , wxVariantOfPtrToObjectConverter##name , NULL , wxObjectToVariantConverter##name); \
1347 template<> void wxStringReadValue(const wxString & , name & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") ) ;}\
1348 template<> void wxStringWriteValue(wxString & , name const & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1349 template<> void wxStringReadValue(const wxString & , name * & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") ) ;}\
1350 template<> void wxStringWriteValue(wxString & , name* const & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1351 template<> void wxStringReadValue(const wxString & , name ** & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1352 template<> void wxStringWriteValue(wxString & , name** const & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1353 template<> const wxTypeInfo* wxGetTypeInfo( name *** ){ static wxBuiltInTypeInfo s_typeInfo(wxT_VOID ) ; wxASSERT_MSG(0 , wxT("illegal specialization called") ) ; return &s_typeInfo ; } \
1354 template<> const wxTypeInfo* wxGetTypeInfo( name * ){ static wxClassTypeInfo s_typeInfo(wxT_OBJECT , &name::sm_class##name) ; return &s_typeInfo ; } \
1355 template<> const wxTypeInfo* wxGetTypeInfo( name ** ){ static wxClassTypeInfo s_typeInfo(wxT_OBJECT_PTR , &name::sm_class##name) ; return &s_typeInfo ; }
1357 #define _IMPLEMENT_DYNAMIC_CLASS_WITH_COPY(name, basename, unit) \
1358 wxObject* wxConstructorFor##name() \
1359 { return new name; } \
1360 const wxClassInfo* name::sm_classParents##name[] = { &basename::sm_class##basename ,NULL } ; \
1361 wxObject* wxVariantToObjectConverter##name ( wxxVariant &data ) { return &data.Get<name>() ; } \
1362 wxObject* wxVariantOfPtrToObjectConverter##name ( wxxVariant &data ) { return data.Get<name*>() ; } \
1363 wxxVariant wxObjectToVariantConverter##name ( wxObject *data ) { return wxxVariant( dynamic_cast<name*> (data) ) ; } \
1364 wxClassInfo name::sm_class##name(sm_classParents##name , wxT(unit) , wxT(#name), \
1365 (int) sizeof(name), \
1366 (wxObjectConstructorFn) wxConstructorFor##name , \
1367 name::GetPropertiesStatic(),name::GetHandlersStatic(),name::sm_constructor##name , name::sm_constructorProperties##name , \
1368 name::sm_constructorPropertiesCount##name , wxVariantOfPtrToObjectConverter##name , wxVariantToObjectConverter##name , wxObjectToVariantConverter##name); \
1369 template<> void wxStringReadValue(const wxString & , name & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") ) ;}\
1370 template<> void wxStringWriteValue(wxString & , name const & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1371 template<> void wxStringReadValue(const wxString & , name * & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") ) ;}\
1372 template<> void wxStringWriteValue(wxString & , name* const & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1373 template<> void wxStringReadValue(const wxString & , name ** & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1374 template<> void wxStringWriteValue(wxString & , name** const & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1375 template<> const wxTypeInfo* wxGetTypeInfo( name *** ){ static wxBuiltInTypeInfo s_typeInfo(wxT_VOID ) ; wxASSERT_MSG(0 , wxT("illegal specialization called") ) ; return &s_typeInfo ; } \
1376 template<> const wxTypeInfo* wxGetTypeInfo( name * ){ static wxClassTypeInfo s_typeInfo(wxT_OBJECT , &name::sm_class##name) ; return &s_typeInfo ; } \
1377 template<> const wxTypeInfo* wxGetTypeInfo( name ** ){ static wxClassTypeInfo s_typeInfo(wxT_OBJECT_PTR , &name::sm_class##name) ; return &s_typeInfo ; }
1379 #define IMPLEMENT_DYNAMIC_CLASS_WITH_COPY( name , basename ) \
1380 _IMPLEMENT_DYNAMIC_CLASS_WITH_COPY( name , basename , "" ) \
1381 const wxPropertyInfo *name::GetPropertiesStatic() { return (wxPropertyInfo*) NULL ; } \
1382 const wxHandlerInfo *name::GetHandlersStatic() { return (wxHandlerInfo*) NULL ; } \
1383 WX_CONSTRUCTOR_DUMMY( name )
1385 #define IMPLEMENT_DYNAMIC_CLASS( name , basename ) \
1386 _IMPLEMENT_DYNAMIC_CLASS( name , basename , "" ) \
1387 wxPropertyInfo *name::GetPropertiesStatic() { return (wxPropertyInfo*) NULL ; } \
1388 wxHandlerInfo *name::GetHandlersStatic() { return (wxHandlerInfo*) NULL ; } \
1389 WX_CONSTRUCTOR_DUMMY( name )
1391 #define IMPLEMENT_DYNAMIC_CLASS_XTI( name , basename , unit ) \
1392 _IMPLEMENT_DYNAMIC_CLASS( name , basename , unit )
1394 #define IMPLEMENT_DYNAMIC_CLASS_WITH_COPY_XTI( name , basename , unit ) \
1395 _IMPLEMENT_DYNAMIC_CLASS_WITH_COPY( name , basename , unit )
1397 // this is for classes that do not derive from wxobject, there are no creators for these
1399 #define IMPLEMENT_DYNAMIC_CLASS_NO_WXOBJECT_NO_BASE_XTI( name , unit ) \
1400 const wxClassInfo* name::sm_classParents##name[] = { NULL } ; \
1401 wxClassInfo name::sm_class##name(sm_classParents##name , wxT("") , wxT(#name), \
1402 (int) sizeof(name), \
1403 (wxObjectConstructorFn) 0 , \
1404 name::GetPropertiesStatic(),name::GetHandlersStatic(),0 , 0 , \
1406 template<> void wxStringReadValue(const wxString & , name * & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1407 template<> void wxStringWriteValue(wxString & , name* const & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1408 template<> void wxStringReadValue(const wxString & , name ** & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1409 template<> void wxStringWriteValue(wxString & , name** const & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1410 template<> const wxTypeInfo* wxGetTypeInfo( name *** ){ static wxBuiltInTypeInfo s_typeInfo(wxT_VOID ) ; wxASSERT_MSG(0 , wxT("illegal specialization called") ) ; return &s_typeInfo ; } \
1411 template<> const wxTypeInfo* wxGetTypeInfo( name * ){ static wxClassTypeInfo s_typeInfo(wxT_OBJECT , &name::sm_class##name) ; return &s_typeInfo ; } \
1412 template<> const wxTypeInfo* wxGetTypeInfo( name ** ){ static wxClassTypeInfo s_typeInfo(wxT_OBJECT_PTR , &name::sm_class##name) ; return &s_typeInfo ; }
1414 // this is for subclasses that still do not derive from wxobject
1416 #define IMPLEMENT_DYNAMIC_CLASS_NO_WXOBJECT_XTI( name , basename, unit ) \
1417 const wxClassInfo* name::sm_classParents##name[] = { &basename::sm_class##basename ,NULL } ; \
1418 wxClassInfo name::sm_class##name(sm_classParents##name , wxT("") , wxT(#name), \
1419 (int) sizeof(name), \
1420 (wxObjectConstructorFn) 0 , \
1421 name::GetPropertiesStatic(),name::GetHandlersStatic(),0 , 0 , \
1423 template<> void wxStringReadValue(const wxString & , name * & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1424 template<> void wxStringWriteValue(wxString & , name* const & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1425 template<> void wxStringReadValue(const wxString & , name ** & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1426 template<> void wxStringWriteValue(wxString & , name** const & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1427 template<> const wxTypeInfo* wxGetTypeInfo( name *** ){ static wxBuiltInTypeInfo s_typeInfo(wxT_VOID ) ; wxASSERT_MSG(0 , wxT("illegal specialization called") ) ; return &s_typeInfo ; } \
1428 template<> const wxTypeInfo* wxGetTypeInfo( name * ){ static wxClassTypeInfo s_typeInfo(wxT_OBJECT , &name::sm_class##name) ; return &s_typeInfo ; } \
1429 template<> const wxTypeInfo* wxGetTypeInfo( name ** ){ static wxClassTypeInfo s_typeInfo(wxT_OBJECT_PTR , &name::sm_class##name) ; return &s_typeInfo ; }
1432 // Multiple inheritance with two base classes
1434 #define _IMPLEMENT_DYNAMIC_CLASS2(name, basename, basename2, unit) \
1435 wxObject* wxConstructorFor##name() \
1436 { return new name; } \
1437 const wxClassInfo* name::sm_classParents##name[] = { &basename::sm_class##basename ,&basename2::sm_class##basename2 , NULL } ; \
1438 wxObject* wxVariantToObjectConverter##name ( wxxVariant &data ) { return data.Get<name*>() ; } \
1439 wxxVariant wxObjectToVariantConverter##name ( wxObject *data ) { return wxxVariant( dynamic_cast<name*> (data) ) ; } \
1440 wxClassInfo name::sm_class##name(sm_classParents##name , wxT(unit) , wxT(#name), \
1441 (int) sizeof(name), \
1442 (wxObjectConstructorFn) wxConstructorFor##name , \
1443 name::GetPropertiesStatic(),name::GetHandlersStatic(),name::sm_constructor##name , name::sm_constructorProperties##name , \
1444 name::sm_constructorPropertiesCount##name , wxVariantToObjectConverter##name , wxObjectToVariantConverter##name); \
1445 template<> void wxStringReadValue(const wxString & , name * & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1446 template<> void wxStringWriteValue(wxString & , name* const & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1447 template<> void wxStringReadValue(const wxString & , name ** & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1448 template<> void wxStringWriteValue(wxString & , name** const & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1449 template<> const wxTypeInfo* wxGetTypeInfo( name *** ){ static wxBuiltInTypeInfo s_typeInfo(wxT_VOID ) ; wxASSERT_MSG(0 , wxT("illegal specialization called") ) ; return &s_typeInfo ; } \
1450 template<> const wxTypeInfo* wxGetTypeInfo( name * ){ static wxClassTypeInfo s_typeInfo(wxT_OBJECT , &name::sm_class##name) ; return &s_typeInfo ; } \
1451 template<> const wxTypeInfo* wxGetTypeInfo( name ** ){ static wxClassTypeInfo s_typeInfo(wxT_OBJECT_PTR , &name::sm_class##name) ; return &s_typeInfo ; }
1453 #define IMPLEMENT_DYNAMIC_CLASS2( name , basename , basename2) \
1454 _IMPLEMENT_DYNAMIC_CLASS2( name , basename , basename2 , "") \
1455 wxPropertyInfo *name::GetPropertiesStatic() { return (wxPropertyInfo*) NULL ; } \
1456 wxHandlerInfo *name::GetHandlersStatic() { return (wxHandlerInfo*) NULL ; } \
1457 WX_CONSTRUCTOR_DUMMY( name )
1459 #define IMPLEMENT_DYNAMIC_CLASS2_XTI( name , basename , basename2, unit) \
1460 _IMPLEMENT_DYNAMIC_CLASS2( name , basename , basename2 , unit)
1462 // -----------------------------------
1463 // for abstract classes
1464 // -----------------------------------
1466 // Single inheritance with one base class
1468 #define _IMPLEMENT_ABSTRACT_CLASS(name, basename) \
1469 const wxClassInfo* name::sm_classParents##name[] = { &basename::sm_class##basename ,NULL } ; \
1470 wxObject* wxVariantToObjectConverter##name ( wxxVariant &data ) { return data.Get<name*>() ; } \
1471 wxObject* wxVariantOfPtrToObjectConverter##name ( wxxVariant &data ) { return data.Get<name*>() ; } \
1472 wxxVariant wxObjectToVariantConverter##name ( wxObject *data ) { return wxxVariant( dynamic_cast<name*> (data) ) ; } \
1473 wxClassInfo name::sm_class##name(sm_classParents##name , wxT("") , wxT(#name), \
1474 (int) sizeof(name), \
1475 (wxObjectConstructorFn) 0 , \
1476 name::GetPropertiesStatic(),name::GetHandlersStatic(),0 , 0 , \
1477 0 , wxVariantOfPtrToObjectConverter##name ,wxVariantToObjectConverter##name , wxObjectToVariantConverter##name); \
1478 template<> void wxStringReadValue(const wxString & , name * & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1479 template<> void wxStringWriteValue(wxString & , name* const & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1480 template<> void wxStringReadValue(const wxString & , name ** & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1481 template<> void wxStringWriteValue(wxString & , name** const & ){wxASSERT_MSG( 0 , wxT("Illegal Spezialication Called") );}\
1482 template<> const wxTypeInfo* wxGetTypeInfo( name * ){ static wxClassTypeInfo s_typeInfo(wxT_OBJECT , &name::sm_class##name) ; return &s_typeInfo ; } \
1483 template<> const wxTypeInfo* wxGetTypeInfo( name ** ){ static wxClassTypeInfo s_typeInfo(wxT_OBJECT_PTR , &name::sm_class##name) ; return &s_typeInfo ; } \
1484 template<> const wxTypeInfo* wxGetTypeInfo( name *** ){ static wxBuiltInTypeInfo s_typeInfo(wxT_VOID) ; assert(0) ; return &s_typeInfo ; }
1486 #define IMPLEMENT_ABSTRACT_CLASS( name , basename ) \
1487 _IMPLEMENT_ABSTRACT_CLASS( name , basename ) \
1488 wxHandlerInfo *name::GetHandlersStatic() { return (wxHandlerInfo*) NULL ; } \
1489 wxPropertyInfo *name::GetPropertiesStatic() { return (wxPropertyInfo*) NULL ; }
1491 // Multiple inheritance with two base classes
1493 #define IMPLEMENT_ABSTRACT_CLASS2(name, basename1, basename2) \
1494 wxClassInfo name::sm_class##name(wxT(#name), wxT(#basename1), \
1495 wxT(#basename2), (int) sizeof(name), \
1496 (wxObjectConstructorFn) 0);
1498 #define IMPLEMENT_CLASS IMPLEMENT_ABSTRACT_CLASS
1499 #define IMPLEMENT_CLASS2 IMPLEMENT_ABSTRACT_CLASS2
1501 // --------------------------------------------------------------------------
1502 // Collection Support
1503 // --------------------------------------------------------------------------
1505 template<typename collection_t
> void wxListCollectionToVariantArray( const collection_t
& coll
, wxxVariantArray
&value
)
1507 collection_t::compatibility_iterator current
= coll
.GetFirst() ;
1510 value
.Add( new wxxVariant(current
->GetData()) ) ;
1511 current
= current
->GetNext();
1515 template<typename collection_t
> void wxArrayCollectionToVariantArray( const collection_t
& coll
, wxxVariantArray
&value
)
1517 for( int i
= 0 ; i
< coll
.GetCount() ; i
++ )
1519 value
.Add( new wxxVariant(coll
[i
]) ) ;