wxWidgets/include/wx/xti.h

/////////////////////////////////////////////////////////////////////////////
// Name:        wx/xti.h
// Purpose:     runtime metadata information (extended class info)
// Author:      Stefan Csomor
// Modified by: 
// Created:     27/07/03
// RCS-ID:      $Id$
// Copyright:   (c) 1997 Julian Smart
//              (c) 2003 Stefan Csomor
// Licence:     wxWindows licence
/////////////////////////////////////////////////////////////////////////////

#ifndef _WX_XTIH__
#define _WX_XTIH__

#if defined(__GNUG__) && !defined(__APPLE__)
#pragma interface "xti.h"
#endif

// We want to support properties, event sources and events sinks through
// explicit declarations, using templates and specialization to make the
// effort as painless as possible. 
//
// This means we have the following domains :
//
// - Type Information for categorizing built in types as well as custom types
// this includes information about enums, their values and names
// - Type safe value storage : a kind of wxVariant, called right now wxxVariant
// which will be merged with wxVariant 
// - Property Information and Property Accessors providing access to a class'
// values and exposed event delegates
// - Information about event handlers
// - extended Class Information for accessing all these

// ----------------------------------------------------------------------------
// headers
// ----------------------------------------------------------------------------

#include "wx/defs.h"
#include "wx/memory.h"
#include "wx/set.h"
#include "wx/string.h"

class WXDLLIMPEXP_BASE wxObject;
class WXDLLIMPEXP_BASE wxClassInfo;
class WXDLLIMPEXP_BASE wxHashTable;
class WXDLLIMPEXP_BASE wxObjectRefData;
class WXDLLIMPEXP_BASE wxEvent;

typedef void (wxObject::*wxObjectEventFunction)(wxEvent&);

// ----------------------------------------------------------------------------
// Enum Support
//
// In the header files there would no change from pure c++ code, in the 
// implementation, an enum would have
// to be enumerated eg :
//
// WX_BEGIN_ENUM( wxFlavor )
//   WX_ENUM_MEMBER( Vanilla )
//   WX_ENUM_MEMBER( Chocolate )
//   WX_ENUM_MEMBER( Strawberry )
// WX_END_ENUM( wxFlavor )
// ----------------------------------------------------------------------------

struct WXDLLIMPEXP_BASE wxEnumMemberData
{
    const wxChar*	m_name;
    int				m_value;
};

class WXDLLIMPEXP_BASE wxEnumData
{
public :
	wxEnumData( wxEnumMemberData* data ) ;

	// returns true if the member has been found and sets the int value
	// pointed to accordingly (if ptr != null )
	// if not found returns false, value left unchanged
	bool HasEnumMemberValue( const wxChar *name , int *value = NULL ) ;
	
	// returns the value of the member, if not found in debug mode an
	// assert is issued, in release 0 is returned
	int GetEnumMemberValue(const wxChar *name );
	
	// returns the name of the enum member having the passed in value
	// returns an emtpy string if not found
    const wxChar *GetEnumMemberName(int value);
	
	// returns the number of members in this enum
	int GetEnumCount() { return m_count ; }
	
	// returns the value of the nth member
	int GetEnumMemberValueByIndex( int n ) ;
	
	// returns the value of the nth member
	const wxChar *GetEnumMemberNameByIndex( int n ) ;
private :
    wxEnumMemberData *m_members;
	int m_count ;
};

#define WX_BEGIN_ENUM( e ) \
	wxEnumMemberData s_enumDataMembers##e[] = {

#define WX_ENUM_MEMBER( v ) { #v, v } ,

#define WX_END_ENUM( e ) { NULL , 0 } } ; \
	wxEnumData s_enumData##e( s_enumDataMembers##e ) ; \
	wxEnumData *wxGetEnumData(e) { return &s_enumData##e ; } \
	template<> const wxTypeInfo* wxGetTypeInfo( e * ){ static wxEnumTypeInfo s_typeInfo(wxT_ENUM , &s_enumData##e) ; return &s_typeInfo ; } \
	template<> void wxStringReadValue(const wxString& s , e &data ) \
	{ \
		data = (e) s_enumData##e.GetEnumMemberValue(s) ; \
	} \
	template<> void wxStringWriteValue(wxString &s , const e &data ) \
	{ \
		s =  s_enumData##e.GetEnumMemberName((int)data) ; \
	}

// ----------------------------------------------------------------------------
// Set Support
// 
// in the header :
// 
// enum wxFlavor
// {  
// 	Vanilla,
// 	Chocolate,
// 	Strawberry,
// };
// 
// typedef wxSet<wxFlavor> wxCoupe ;
// 
// in the implementation file :
// 
// WX_BEGIN_ENUM( wxFlavor )
// 	WX_ENUM_MEMBER( Vanilla )
// 	WX_ENUM_MEMBER( Chocolate )
// 	WX_ENUM_MEMBER( Strawberry )
// WX_END_ENUM( wxFlavor )
// 
// WX_IMPLEMENT_SET_STREAMING( wxCoupe , wxFlavor ) 
//
// implementation note : no partial specialization for streaming, but a delegation to a 
// different class
//
// ----------------------------------------------------------------------------

// in order to remove dependancy on string tokenizer
void wxSetStringToArray( const wxString &s , wxArrayString &array ) ;

template<typename e>
void wxSetFromString(const wxString &s , wxSet<e> &data )  
{
	wxEnumData* edata = wxGetEnumData((e) 0) ;
	data.Clear() ;

	wxArrayString array ;
	wxSetStringToArray( s , array ) ;
    wxString flag;
    for ( int i = 0 ; i < array.Count() ; ++i )
    {
        flag = array[i] ;
		int ivalue ;
		if ( edata->HasEnumMemberValue( flag , &ivalue ) )
		{
			data.Set( (e) ivalue ) ;
		}
    }
}

template<typename e>
void wxSetToString( wxString &s , const wxSet<e> &data )
{
	wxEnumData* edata = wxGetEnumData((e) 0) ;
	int count = edata->GetEnumCount() ;
	int i ;
	s.Clear() ;
	for ( i = 0 ; i < count ; i++ )
	{
		e value = (e) edata->GetEnumMemberValueByIndex(i) ;
		if ( data.Contains( value ) )
		{
			// this could also be done by the templated calls
			if ( !s.IsEmpty() )
				s +="|" ;
			s += edata->GetEnumMemberNameByIndex(i) ;
		}
	}
}

//  if the wxSet specialization above does not work for all compilers, add this to the WX_IMPLEMENT_SET_STREAMING macro
//	template<> const wxTypeInfo* wxGetTypeInfo( SetName * ){ static wxEnumTypeInfo s_typeInfo(wxT_SET , &s_enumData##e) ; return &s_typeInfo ; }\

#define WX_IMPLEMENT_SET_STREAMING(SetName,e) \
	template<> void wxStringReadValue(const wxString &s , wxSet<e> &data ) \
	{ \
		wxSetFromString( s , data ) ; \
	} \
	template<> void wxStringWriteValue( wxString &s , const wxSet<e> &data ) \
	{ \
		wxSetToString( s , data ) ; \
	} \


// ----------------------------------------------------------------------------
// Type Information
// ----------------------------------------------------------------------------

enum wxTypeKind
{
    wxT_VOID = 0, // unknown type
    wxT_BOOL,
    wxT_CHAR,
    wxT_UCHAR,
    wxT_INT,
    wxT_UINT,
    wxT_LONG,
    wxT_ULONG,
    wxT_FLOAT,
    wxT_DOUBLE,
    wxT_STRING, // must be wxString
    wxT_SET, // must be wxSet<> template
    wxT_ENUM,
    wxT_OBJECT, // must be a component (pointer !!!)
    wxT_CUSTOM, // user defined type (e.g. wxPoint)
	wxT_DELEGATE , // for connecting against an event source
    wxT_LAST_TYPE_KIND // sentinel for bad data, asserts, debugging
};

class WXDLLIMPEXP_BASE wxTypeInfo
{
public :
	wxTypeInfo() : m_kind( wxT_VOID) {}
	virtual ~wxTypeInfo() {}
	wxTypeKind GetKind() const { return m_kind ; }
protected :
	wxTypeKind m_kind ;
};

class WXDLLIMPEXP_BASE wxBuiltInTypeInfo : public wxTypeInfo
{
public :
	wxBuiltInTypeInfo( wxTypeKind kind ) { assert( kind < wxT_SET ) ; m_kind = kind ;}
} ;

class WXDLLIMPEXP_BASE wxCustomTypeInfo : public wxTypeInfo
{
public :
	wxCustomTypeInfo( const wxChar *typeName ) 
	{ m_kind = wxT_CUSTOM ; m_typeName = typeName ;}
	const wxChar *GetTypeName() const { assert( m_kind == wxT_CUSTOM ) ; return m_typeName ; }
private :
	const wxChar *m_typeName; // Kind == wxT_CUSTOM
} ;

class WXDLLIMPEXP_BASE wxEnumTypeInfo : public wxTypeInfo
{
public :
	wxEnumTypeInfo( wxTypeKind kind , wxEnumData* enumInfo ) 
	{ assert( kind == wxT_ENUM || kind == wxT_SET ) ; m_kind = kind ; m_enumInfo = enumInfo ;}
	const wxEnumData* GetEnumData() const { assert( m_kind == wxT_ENUM || m_kind == wxT_SET ) ; return m_enumInfo ; }
private :
	wxEnumData *m_enumInfo; // Kind == wxT_ENUM or Kind == wxT_SET
} ;

class WXDLLIMPEXP_BASE wxClassTypeInfo : public wxTypeInfo
{
public :
	wxClassTypeInfo( wxClassInfo* classInfo ) 
	{ m_kind = wxT_OBJECT ; m_classInfo = classInfo ;}
	const wxClassInfo *GetClassInfo() const { assert( m_kind == wxT_OBJECT ) ; return m_classInfo ; }
private :
	wxClassInfo *m_classInfo; // Kind == wxT_OBJECT - could be NULL
} ;

// a delegate is an exposed event source 

class WXDLLIMPEXP_BASE wxDelegateTypeInfo : public wxTypeInfo
{
public :
	wxDelegateTypeInfo( int eventType , wxClassInfo* eventClass ) 
	{ m_kind = wxT_DELEGATE ; m_eventClass = eventClass ; m_eventType = eventType ;}
	const wxClassInfo *GetEventClass() const { assert( m_kind == wxT_DELEGATE ) ; return m_eventClass ; }
	int GetEventType() const { assert( m_kind == wxT_DELEGATE ) ; return m_eventType ; }
private :
	const wxClassInfo *m_eventClass; // (extended will merge into classinfo)
	int m_eventType ;
} ;

template<typename T> const wxTypeInfo* wxGetTypeInfo( T * ) ;

template<typename T> const wxTypeInfo* wxGetTypeInfo( wxSet<T> * ) 
{
	static wxEnumTypeInfo s_typeInfo(wxT_SET , wxGetEnumData((T) 0) ) ; return &s_typeInfo ; 
}

// this macro is for usage with custom, non-object derived classes and structs, wxPoint is such a custom type

#define WX_CUSTOM_TYPE_INFO( e ) \
	template<> const wxTypeInfo* wxGetTypeInfo( e * ){ static wxCustomTypeInfo s_typeInfo(#e) ; return &s_typeInfo ; } \

// ----------------------------------------------------------------------------
// value streaming 
//
// streaming is defined for xml constructs right now, the aim is to make this
// pluggable in the future
// ----------------------------------------------------------------------------

// convenience function (avoids including xml headers in users code)

class wxXmlNode ;
void wxXmlAddContentToNode( wxXmlNode* node , const wxString& data ) ;
wxString wxXmlGetContentFromNode( wxXmlNode *node ) ;

// templated streaming, every type must have their specialization for these methods

template<typename T>
void wxStringReadValue( const wxString &s , T &data ) ;

template<typename T>
void wxStringWriteValue( wxString &s , const T &data) ;

// for simple types this default implementation is ok, composited structures will have to
// loop through their properties 

template<typename T>
void wxXmlReadValue( wxXmlNode *node , T &data ) 
{
	wxStringReadValue<T>( wxXmlGetContentFromNode( node ) , data ) ;
}

template<typename T>
void wxXmlWriteValue( wxXmlNode *node , const T &data) 
{
	wxString s ;
	wxStringWriteValue<T>( s, data ) ;
	wxXmlAddContentToNode( node ,s ) ;
}

// ----------------------------------------------------------------------------
// wxxVariant as typesafe data holder
// ----------------------------------------------------------------------------

class WXDLLIMPEXP_BASE wxxVariantData
{
public:
	virtual ~wxxVariantData() {}

	// return a heap allocated duplicate
	virtual wxxVariantData* Clone() const = 0 ;

	// returns the type info of the contentc
	virtual const wxTypeInfo* GetTypeInfo() const = 0 ;

	// write the value into an xml node
	virtual void Write( wxXmlNode* node ) const = 0 ;

	// read the value from the xml node
	virtual void Read( wxXmlNode* node ) = 0 ;

	// write the value into a string
	virtual void Write( wxString &s ) const = 0 ;

	// read the value from a string
	virtual void Read( const wxString &s) = 0 ;
} ;

template<typename T> class WXDLLIMPEXP_BASE wxxVariantDataT : public wxxVariantData
{
public:
    wxxVariantDataT(T d) : m_data(d) {}
	virtual ~wxxVariantDataT() {}

	// get a copy of the stored data
    T Get() const { return m_data; }

	// set the data
    void Set(T d) { m_data =  d; }

	// return a heap allocated duplicate
	virtual wxxVariantData* Clone() const { return new wxxVariantDataT<T>( Get() ) ; }

	// returns the type info of the contentc
	virtual const wxTypeInfo* GetTypeInfo() const { return wxGetTypeInfo( (T*) NULL ) ; }

	// write the value into an xml node
	virtual void Write( wxXmlNode* node ) const { wxXmlWriteValue( node , m_data ) ; }

	// read the value from the xml node
	virtual void Read( wxXmlNode* node ) { wxXmlReadValue( node , m_data ) ; }

	// write the value into a string
	virtual void Write( wxString &s ) const { wxStringWriteValue( s , m_data ) ; }

	// read the value from a string
	virtual void Read( const wxString &s) { wxStringReadValue( s , m_data ) ; }

private:
    T m_data;
};

class WXDLLIMPEXP_BASE wxxVariant
{
public :
	wxxVariant() { m_data = NULL ; }
	wxxVariant( wxxVariantData* data , const wxString& name = wxT("") ) : m_data(data) , m_name(name) {}
	wxxVariant( const wxxVariant &d ) { if ( d.m_data ) m_data = d.m_data->Clone() ; else m_data = NULL ; m_name = d.m_name ; }

	template<typename T> wxxVariant( T data , const wxString& name = wxT("") ) : 
		m_data(new wxxVariantDataT<T>(data) ), m_name(name) {}
	~wxxVariant() { delete m_data ; }

	// get a copy of the stored data
	template<typename T> T Get() const
	{
		wxxVariantDataT<T> *dataptr = dynamic_cast<wxxVariantDataT<T>*> (m_data) ;
		assert( dataptr ) ;
		return dataptr->Get() ;
	}
	
	// stores the data
	template<typename T> Set(T data) const
	{
		delete m_data ;
		m_data = new wxxVariantDataT<T>(data) ;
	}

	wxxVariant& operator=(const wxxVariant &d)
	{
		m_data = d.m_data->Clone() ; 
		m_name = d.m_name ;
		return *this ;
	}
	
	// gets the stored data casted to a wxObject* , returning NULL if cast is not possible
	wxObject* GetAsObject() const ;

	// write the value into an xml node
	void Write( wxXmlNode* node ) const { m_data->Write( node ) ; }

	// read the value from the xml node
	void Read( wxXmlNode* node ) { m_data->Read( node ) ; }

	// write the value into a string
	void Write( wxString &s ) const { m_data->Write( s ) ; }

	// read the value from a string
	void Read( const wxString &s) { m_data->Read( s ) ; }

	// returns this value as string
	wxString GetAsString() const
	{
		wxString s ;
		Write( s ) ;
		return s ;
	}

	void SetFromString( const wxString &s)
	{
		Read( s ) ;
	}
private :
	wxxVariantData* m_data ;
	wxString m_name ;
} ;

// ----------------------------------------------------------------------------
// Property Support
//
// wxPropertyInfo is used to inquire of the property by name.  It doesn't
// provide access to the property, only information about it.  If you
// want access, look at wxPropertyAccessor.
// ----------------------------------------------------------------------------

class WXDLLIMPEXP_BASE wxPropertyAccessor
{
public :
    virtual void SetProperty(wxObject *object, const wxxVariant &value) const = 0 ;
    virtual wxxVariant GetProperty(wxObject *object) const = 0 ;
    virtual bool HasSetter() const = 0 ;
    virtual bool HasGetter() const = 0 ;
	const char * GetGetterName() const { return m_setterName ; }
	const char * GetSetterName() const { return m_getterName ; }
	virtual wxxVariant ReadValue( wxXmlNode* node ) const = 0 ;
	virtual void WriteValue( wxXmlNode* node , wxObject *o ) const = 0 ;
	virtual wxxVariant ReadValue( const wxString &value ) const = 0 ;
	virtual void WriteValue( wxString& value , wxObject *o ) const = 0 ;
protected :
	const char *m_setterName ;
	const char *m_getterName ;
};

template<typename T>
void wxXmlReadValue( wxXmlNode *node , T &data ) ;

template<typename T>
void wxXmlWriteValue( wxXmlNode *node , const T &data) ;

template<class Klass, typename T>
class WXDLLIMPEXP_BASE wxPropertyAccessorT : public wxPropertyAccessor
{
public:
    typedef void (Klass::*setter_t)(T value);
    typedef void (Klass::*setter_ref_t)(T& value);
    typedef T (Klass::*getter_t)() const;
    typedef const T& (Klass::*getter_ref_t)() const;

    wxPropertyAccessorT(setter_t setter, getter_t getter, const char *g, const char *s)
        : m_setter(setter), m_setter_ref(NULL), m_getter(getter) ,m_getter_ref(NULL) {m_setterName = s;m_getterName=g ;}
    wxPropertyAccessorT(setter_ref_t setter, getter_t getter, const char *g, const char *s)
        : m_setter(NULL), m_setter_ref(setter), m_getter(getter) , m_getter_ref(NULL){m_setterName = s;m_getterName=g ;}
    wxPropertyAccessorT(setter_ref_t setter, getter_ref_t getter, const char *g, const char *s)
        : m_setter(NULL), m_setter_ref(setter), m_getter(NULL) , m_getter_ref(getter){m_setterName = s;m_getterName=g ;}
    wxPropertyAccessorT(setter_t setter, getter_ref_t getter, const char *g, const char *s)
        : m_setter(NULL), m_setter(setter), m_getter(NULL) ,  m_getter_ref(getter){m_setterName = s;m_getterName=g ;}

	// returns true if this accessor has a setter
	bool HasSetter() const { return m_setter != NULL || m_setter_ref != NULL ; }

	// return true if this accessor has a getter
	bool HasGetter() const { return m_getter != NULL || m_getter_ref != NULL ; }

	// set the property this accessor is responsible for in an object
	void SetProperty(wxObject *o, const wxxVariant &v) const
    {
        Klass *obj = dynamic_cast<Klass*>(o);
        T value = v.Get<T>();
        if (m_setter)
            (obj->*(m_setter))(value);
        else
            (obj->*(m_setter_ref))(value);
    }

	// gets the property this accessor is responsible for from an object
    wxxVariant GetProperty(wxObject *o) const
    {
		return wxxVariant( (wxxVariantData* ) DoGetProperty( o ) ) ;
     }

	// write the property this accessor is responsible for from an object into
	// a xml node
	void WriteValue( wxXmlNode* node , wxObject *o ) const
	{
		DoGetProperty( o )->Write( node ) ;
	}

	// write the property this accessor is responsible for from an object into
	// a string
	void WriteValue( wxString& s , wxObject *o ) const
	{
		DoGetProperty( o )->Write( s ) ;
	}

	// read a wxxVariant having the correct type for the property this accessor
	// is responsible for from an xml node
	wxxVariant ReadValue( wxXmlNode* node ) const
	{
		T data ;
		wxXmlReadValue( node , data ) ;
		return wxxVariant( data ) ;
	}

	// read a wxxVariant having the correct type for the property this accessor
	// is responsible for from a string
	wxxVariant ReadValue( const wxString &value ) const
	{
		T data ;
		wxStringReadValue( value , data ) ;
		return wxxVariant( data ) ;
	}

private :
    wxxVariantDataT<T>* DoGetProperty(wxObject *o) const
    {
        Klass *obj = dynamic_cast<Klass*>(o);
		if ( m_getter )
			return new wxxVariantDataT<T>( (obj->*(m_getter))() ) ;
		else
			return new wxxVariantDataT<T>( (obj->*(m_getter_ref))() ) ;
    }

    setter_t m_setter;
    setter_ref_t m_setter_ref;
    getter_t m_getter;
	getter_ref_t m_getter_ref ;
};

class WXDLLIMPEXP_BASE wxPropertyInfo
{
public :
	wxPropertyInfo( wxPropertyInfo* &iter , const char *name , const char *typeName , const wxTypeInfo* typeInfo , wxPropertyAccessor *accessor , wxxVariant dv ) :
	   m_name( name ) , m_typeName(typeName) , m_typeInfo( typeInfo ) , m_accessor( accessor ) , m_defaultValue( dv )
	{
		m_next = iter ;
		iter = this ;
	}
	// return the name of this property
	const char *		GetName() const { return m_name ; }

	// return the typename of this property
	const char *		GetTypeName() const { return m_typeName ; }

	// return the type info of this property
	const wxTypeInfo *	GetTypeInfo() const { return m_typeInfo ; }

	// return the accessor for this property
	wxPropertyAccessor* GetAccessor() const { return m_accessor ; }

	// returns NULL if this is the last property of this class
	wxPropertyInfo*     GetNext() const { return m_next ; }
private : 
	const char *		m_name;
	const char *		m_typeName ;
	const wxTypeInfo*	m_typeInfo ;
	wxPropertyAccessor* m_accessor ;
    wxxVariant m_defaultValue; 
	// string representation of the default value
	//  to be assigned by the designer to the property
	//  when the component is dropped on the container.
	wxPropertyInfo*		m_next ;
};

#define WX_BEGIN_PROPERTIES_TABLE(theClass) \
    const wxPropertyInfo *theClass::GetPropertiesStatic()  \
    {  \
        typedef theClass class_t; \
		static wxPropertyInfo* first = NULL ;

#define WX_END_PROPERTIES_TABLE() \
		return first ; } 

#define WX_PROPERTY( name , type , setter , getter ,defaultValue ) \
	static wxPropertyAccessorT<class_t , type> _accessor##name( setter , getter , #setter , #getter ) ; \
	static wxPropertyInfo _propertyInfo##name( first , #name , #type , wxGetTypeInfo( (type*) NULL ) ,&_accessor##name , wxxVariant(defaultValue) ) ;

#define WX_DELEGATE( name , eventType , eventClass ) \
	static wxDelegateTypeInfo _typeInfo##name( eventType , CLASSINFO( eventClass ) ) ; \
	static wxPropertyInfo _propertyInfo##name( first , #name , NULL , &_typeInfo##name , NULL , wxxVariant() ) ; \

// ----------------------------------------------------------------------------
// Handler Info
//
// this is describing an event sink
// ----------------------------------------------------------------------------

class wxHandlerInfo
{
public :
	wxHandlerInfo( wxHandlerInfo* &iter , const wxChar *name , wxObjectEventFunction address , const wxClassInfo* eventClassInfo ) :
	   m_name( name ) , m_eventClassInfo( eventClassInfo ) , m_eventFunction( address )  
	{
		m_next = iter ;
		iter = this ;
	}

	// get the name of the handler method
	const char *		GetName() const { return m_name ; }

	// return the class info of the event
	const wxClassInfo *	GetEventClassInfo() const { return m_eventClassInfo ; }

	// get the handler function pointer
	wxObjectEventFunction	GetEventFunction() const { return m_eventFunction ; }

	// returns NULL if this is the last handler of this class
	wxHandlerInfo*     GetNext() const { return m_next ; }
private : 
	const wxChar *		m_name;
	wxObjectEventFunction m_eventFunction ;
	const wxClassInfo*	m_eventClassInfo ;
	wxHandlerInfo*		m_next ;
};

#define WX_HANDLER(name,eventClassType) \
	static wxHandlerInfo _handlerInfo##name( first , #name , (wxObjectEventFunction) &name , CLASSINFO( eventClassType ) ) ;

#define WX_BEGIN_HANDLERS_TABLE(theClass) \
    const wxHandlerInfo *theClass::GetHandlersStatic()  \
    {  \
        typedef theClass class_t; \
		static wxHandlerInfo* first = NULL ;

#define WX_END_HANDLERS_TABLE() \
		return first ; } 

// ----------------------------------------------------------------------------
// Constructor Bridges
//
// allow to set up constructors with params during runtime
// ----------------------------------------------------------------------------

class WXDLLIMPEXP_BASE wxConstructorBridge
{
public :
    virtual void Create(wxObject *o, wxxVariant *args) = 0;
};

// Creator Bridges for all Numbers of Params

// no params

template<typename Class>
struct wxConstructorBridge_0 : public wxConstructorBridge
{
    void Create(wxObject *o, wxxVariant *)
    {
        Class *obj = dynamic_cast<Class*>(o);
        obj->Create();
    }
};

struct wxConstructorBridge_Dummy : public wxConstructorBridge
{
    void Create(wxObject *, wxxVariant *)
    {
    }
} ;

#define WX_CONSTRUCTOR_0(klass) \
	wxConstructorBridge_0<klass> constructor##klass ; \
	wxConstructorBridge* klass::sm_constructor##klass = &constructor##klass ; \
	const char *klass::sm_constructorProperties##klass[] = { NULL } ; \
	const int klass::sm_constructorPropertiesCount##klass = 0 ;

#define WX_CONSTRUCTOR_DUMMY(klass) \
	wxConstructorBridge_Dummy constructor##klass ; \
	wxConstructorBridge* klass::sm_constructor##klass = &constructor##klass ; \
	const char *klass::sm_constructorProperties##klass[] = { NULL } ; \
	const int klass::sm_constructorPropertiesCount##klass = 0 ;

// 1 param

template<typename Class, typename T0>
struct wxConstructorBridge_1 : public wxConstructorBridge
{
    void Create(wxObject *o, wxxVariant *args)
    {
        Class *obj = dynamic_cast<Class*>(o);
        obj->Create(
                    args[0].Get<T0>()
                   );
    }
};

#define WX_CONSTRUCTOR_1(klass,t0,v0) \
	wxConstructorBridge_1<klass,t0> constructor##klass ; \
	wxConstructorBridge* klass::sm_constructor##klass = &constructor##klass ; \
	const char *klass::sm_constructorProperties##klass[] = { #v0 } ; \
	const int klass::sm_constructorPropertiesCount##klass = 1 ;

// 2 params

template<typename Class,
         typename T0, typename T1>
struct wxConstructorBridge_2 : public wxConstructorBridge
{
    void Create(wxObject *o, wxxVariant *args[])
    {
        Class *obj = dynamic_cast<Class*>(o);
        obj->Create(
                    args[0].Get<T0>() ,
                    args[1].Get<T1>() 
                   );
    }
};

#define WX_CONSTRUCTOR_2(klass,t0,v0,t1,v1) \
	wxConstructorBridge_2<klass,t0,t1> constructor##klass ; \
	klass::sm_constructor##klass = &constructor##klass ; \
	klass::sm_constructorProperties##klass[] = { #v0 , #v1 } ; \
	klass::sm_constructorPropertiesCount##klass = 2;

// 3 params

template<typename Class,
         typename T0, typename T1, typename T2>
struct wxConstructorBridge_3 : public wxConstructorBridge
{
    void Create(wxObject *o, wxxVariant *args[])
    {
        Class *obj = dynamic_cast<Class*>(o);
        obj->Create(
                    args[0].Get<T0>() ,
                    args[1].Get<T1>() ,
                    args[2].Get<T2>() 
                   );
    }
};

#define WX_CONSTRUCTOR_3(klass,t0,v0,t1,v1,t2,v2) \
	wxConstructorBridge_3<klass,t0,t1,t2> constructor##klass ; \
	klass::sm_constructor##klass = &constructor##klass ; \
	klass::sm_constructorProperties##klass[] = { #v0 , #v1 , #v2 } ; \
	klass::sm_constructorPropertiesCount##klass = 3 ;

// 4 params

template<typename Class,
         typename T0, typename T1, typename T2, typename T3>
struct wxConstructorBridge_4 : public wxConstructorBridge
{
    void Create(wxObject *o, wxxVariant *args[])
    {
        Class *obj = dynamic_cast<Class*>(o);
        obj->Create(
                    args[0].Get<T0>() ,
                    args[1].Get<T1>() ,
                    args[2].Get<T2>() ,
                    args[3].Get<T3>() 
                   );
    }
};

#define WX_CONSTRUCTOR_4(klass,t0,v0,t1,v1,t2,v2,t3,v3) \
	wxConstructorBridge_4<klass,t0,t1,t2,t3> constructor##klass ; \
	klass::sm_constructor##klass = &constructor##klass ; \
	klass::sm_constructorProperties##klass[] = { #v0 , #v1 , #v2 , #v3 } ; \
	klass::sm_constructorPropertiesCount##klass = 4 ;

// ----------------------------------------------------------------------------
// wxClassInfo
// ----------------------------------------------------------------------------

typedef wxObject *(*wxObjectConstructorFn)(void);
typedef wxObject* (*wxVariantToObjectConverter)( const wxxVariant &data ) ;
typedef wxxVariant (*wxObjectToVariantConverter)( wxObject* ) ;

class WXDLLIMPEXP_BASE wxClassInfo
{
public:
    wxClassInfo(const wxClassInfo **_Parents,
			const char *_UnitName,
			const char *_ClassName,
            int size,
            wxObjectConstructorFn ctor ,
			const wxPropertyInfo *_Props ,
			wxConstructorBridge* _Constructor ,
			const char ** _ConstructorProperties , 
			const int _ConstructorPropertiesCount ,
			wxVariantToObjectConverter _Converter1 ,
			wxObjectToVariantConverter _Converter2 
			) : m_parents(_Parents) , m_unitName(_UnitName) ,m_className(_ClassName),
			m_objectSize(size), m_objectConstructor(ctor) , m_firstProperty(_Props ) , m_constructor( _Constructor ) ,
			m_constructorProperties(_ConstructorProperties) , m_constructorPropertiesCount(_ConstructorPropertiesCount),
			m_variantToObjectConverter( _Converter1 ) , m_objectToVariantConverter( _Converter2 ) , m_next(sm_first)
	{
		sm_first = this; 
		Register( m_className , this ) ;
	}

    ~wxClassInfo() ;

    wxObject *CreateObject() { return m_objectConstructor ? (*m_objectConstructor)() : 0; }

    const wxChar       *GetClassName() const { return m_className; }
    const wxClassInfo **GetParents() const { return m_parents; }
    int                 GetSize() const { return m_objectSize; }

    wxObjectConstructorFn      GetConstructor() const { return m_objectConstructor; }
    static const wxClassInfo  *GetFirst() { return sm_first; }
    const wxClassInfo         *GetNext() const { return m_next; }
    static wxClassInfo        *FindClass(const wxChar *className);

        // Climb upwards through inheritance hierarchy.
        // Dual inheritance is catered for.

    bool IsKindOf(const wxClassInfo *info) const
    {
		if ( info != 0 )
		{
			if ( info == this )
				return true ;

			for ( int i = 0 ; m_parents[i] ; ++ i )
			{
				if ( m_parents[i]->IsKindOf( info ) )
					return true ;
			}
		}
		return false ;
    }

    // Initializes parent pointers and hash table for fast searching.
	// this is going to be removed by Register/Unregister calls
	// in Constructor / Destructor together with making the hash map private

    static void     InitializeClasses();

    // Cleans up hash table used for fast searching.

    static void     CleanUpClasses();

	// returns the first property
	const wxPropertyInfo* GetFirstProperty() const { return m_firstProperty ; } 

	// returns the first handler 
	const wxHandlerInfo* GetFirstHandler() const { return m_firstHandler ; } 

    // Call the Create method for a class
    virtual void Create (wxObject *object, int ParamCount, wxxVariant *Params) 
	{
		wxASSERT( ParamCount == m_constructorPropertiesCount ) ;
		m_constructor->Create( object , Params ) ;
	}

	// get number of parameters for constructor
	virtual int GetCreateParamCount() const { return m_constructorPropertiesCount; }

	// get i-th constructor parameter
	virtual const wxChar* GetCreateParamName(int i) const { return m_constructorProperties[i] ; }

   // Runtime access to objects by property name, and variant data
    virtual void SetProperty (wxObject *object, const char *PropertyName, const wxxVariant &Value);
    virtual wxxVariant GetProperty (wxObject *object, const char *PropertyName);

	// we must be able to cast variants to wxObject pointers, templates seem not to be suitable
	wxObject* VariantToInstance( const wxxVariant &data ) const { return m_variantToObjectConverter( data ) ; }
	wxxVariant InstanceToVariant( wxObject *object ) const { return m_objectToVariantConverter( object ) ; }
    
	// find property by name
    virtual const wxPropertyInfo *FindPropInfo (const char *PropertyName) const ;

public:
    const wxChar            *m_className;
    int                      m_objectSize;
    wxObjectConstructorFn    m_objectConstructor;

    // class info object live in a linked list:
    // pointers to its head and the next element in it

    static wxClassInfo      *sm_first;
    wxClassInfo             *m_next;

	// FIXME: this should be private (currently used directly by way too
    //        many clients)
    static wxHashTable      *sm_classTable;

private:
	const wxClassInfo**		m_parents ;
 	const wxPropertyInfo *	m_firstProperty ;
  	const wxHandlerInfo *	m_firstHandler ;
    const wxChar*			m_unitName;

	wxConstructorBridge*	m_constructor ;
	const wxChar **			m_constructorProperties ; 
	const int				m_constructorPropertiesCount ;
	wxVariantToObjectConverter m_variantToObjectConverter ; 
	wxObjectToVariantConverter m_objectToVariantConverter ;

    const wxPropertyAccessor *FindAccessor (const char *propertyName);

	// registers the class
	static void Register(const wxChar *name, wxClassInfo *info);
	
	static void Unregister(const wxChar *name);

	// InitializeClasses() helper
    static wxClassInfo *GetBaseByName(const wxChar *name);

    DECLARE_NO_COPY_CLASS(wxClassInfo)
};

WXDLLIMPEXP_BASE wxObject *wxCreateDynamicObject(const wxChar *name);

// ----------------------------------------------------------------------------
// Dynamic class macros
// ----------------------------------------------------------------------------

#define _DECLARE_DYNAMIC_CLASS(name)           \
 public:                                      \
  static wxClassInfo sm_class##name;          \
  static const wxClassInfo* sm_classParents##name[] ; \
  static const wxPropertyInfo* GetPropertiesStatic() ; \
  static const wxHandlerInfo* GetHandlersStatic() ; \
  virtual wxClassInfo *GetClassInfo() const   \
   { return &name::sm_class##name; }

#define DECLARE_DYNAMIC_CLASS(name)           \
	_DECLARE_DYNAMIC_CLASS(name) \
	static wxConstructorBridge* sm_constructor##name ; \
	static const char * sm_constructorProperties##name[] ; \
	static const int sm_constructorPropertiesCount##name ;

#define DECLARE_DYNAMIC_CLASS_NO_ASSIGN(name)   \
    DECLARE_NO_ASSIGN_CLASS(name)               \
    DECLARE_DYNAMIC_CLASS(name)

#define DECLARE_DYNAMIC_CLASS_NO_COPY(name)   \
    DECLARE_NO_COPY_CLASS(name)               \
    DECLARE_DYNAMIC_CLASS(name)

#define DECLARE_ABSTRACT_CLASS(name) _DECLARE_DYNAMIC_CLASS(name)
#define DECLARE_CLASS(name) DECLARE_DYNAMIC_CLASS(name)

// -----------------------------------
// for concrete classes
// -----------------------------------

    // Single inheritance with one base class

#define _IMPLEMENT_DYNAMIC_CLASS(name, basename, unit)                 \
 wxObject* wxConstructorFor##name()                             \
  { return new name; }                                          \
 const wxClassInfo* name::sm_classParents##name[] = { &basename::sm_class##basename ,NULL } ; \
 wxObject* wxVariantToObjectConverter##name ( const wxxVariant &data ) { return data.Get<name*>() ; } \
 wxxVariant wxObjectToVariantConverter##name ( wxObject *data ) { return wxxVariant( dynamic_cast<name*> (data)  ) ; } \
 wxClassInfo name::sm_class##name(sm_classParents##name , wxT(unit) , wxT(#name),   \
            (int) sizeof(name),                              \
            (wxObjectConstructorFn) wxConstructorFor##name   ,   \
			name::GetPropertiesStatic(),name::sm_constructor##name , name::sm_constructorProperties##name ,     \
			name::sm_constructorPropertiesCount##name , wxVariantToObjectConverter##name , wxObjectToVariantConverter##name);    \
 template<> void wxStringReadValue(const wxString & , name * & ){assert(0) ;}\
 template<> void wxStringWriteValue(wxString & , name* const & ){assert(0) ;}\
 template<> const wxTypeInfo* wxGetTypeInfo( name ** ){ static wxClassTypeInfo s_typeInfo(&name::sm_class##name) ; return &s_typeInfo ; }

#define IMPLEMENT_DYNAMIC_CLASS( name , basename ) \
_IMPLEMENT_DYNAMIC_CLASS( name , basename , "" ) \
const wxPropertyInfo *name::GetPropertiesStatic() { return (wxPropertyInfo*) NULL ; } \
WX_CONSTRUCTOR_DUMMY( name )

#define IMPLEMENT_DYNAMIC_CLASS_XTI( name , basename , unit ) \
_IMPLEMENT_DYNAMIC_CLASS( name , basename , unit )

// this is for classes that do not derive from wxobject, there are no creators for these 

#define IMPLEMENT_DYNAMIC_CLASS_NO_WXOBJECT_NO_BASE_XTI( name , unit ) \
 const wxClassInfo* name::sm_classParents##name[] = { NULL } ; \
 wxClassInfo name::sm_class##name(sm_classParents##name , wxT("") , wxT(#name),   \
            (int) sizeof(name),                              \
            (wxObjectConstructorFn) 0   ,   \
			name::GetPropertiesStatic(),0 , 0 ,     \
			0 , 0 , 0 );    \
 template<> void wxStringReadValue(const wxString & , name * & ){assert(0) ;}\
 template<> void wxStringWriteValue(wxString & , name* const & ){assert(0) ;}\
 template<> const wxTypeInfo* wxGetTypeInfo( name ** ){ static wxClassTypeInfo s_typeInfo(&name::sm_class##name) ; return &s_typeInfo ; }

// this is for subclasses that still do not derive from wxobject

#define IMPLEMENT_DYNAMIC_CLASS_NO_WXOBJECT_XTI( name , basename, unit ) \
 const wxClassInfo* name::sm_classParents##name[] = { &basename::sm_class##basename ,NULL } ; \
 wxClassInfo name::sm_class##name(sm_classParents##name , wxT("") , wxT(#name),   \
            (int) sizeof(name),                              \
            (wxObjectConstructorFn) 0   ,   \
			name::GetPropertiesStatic(),0 , 0 ,     \
			0 , 0 , 0 );    \
 template<> void wxStringReadValue(const wxString & , name * & ){assert(0) ;}\
 template<> void wxStringWriteValue(wxString & , name* const & ){assert(0) ;}\
 template<> const wxTypeInfo* wxGetTypeInfo( name ** ){ static wxClassTypeInfo s_typeInfo(&name::sm_class##name) ; return &s_typeInfo ; }

    // Multiple inheritance with two base classes

#define _IMPLEMENT_DYNAMIC_CLASS2(name, basename, basename2, unit)                 \
 wxObject* wxConstructorFor##name()                             \
  { return new name; }                                          \
  const wxClassInfo* name::sm_classParents##name[] = { &basename::sm_class##basename ,&basename2::sm_class##basename2 , NULL } ; \
 wxObject* wxVariantToObjectConverter##name ( const wxxVariant &data ) { return data.Get<name*>() ; } \
 wxxVariant wxObjectToVariantConverter##name ( wxObject *data ) { return wxxVariant( dynamic_cast<name*> (data)  ) ; } \
 wxClassInfo name::sm_class##name(sm_classParents##name , wxT(unit) , wxT(#name),   \
            (int) sizeof(name),                              \
            (wxObjectConstructorFn) wxConstructorFor##name   ,   \
			name::GetPropertiesStatic(),name::sm_constructor##name , name::sm_constructorProperties##name ,     \
			name::sm_constructorPropertiesCount##name , wxVariantToObjectConverter##name , wxObjectToVariantConverter##name);    \
 template<> void wxStringReadValue(const wxString & , name * & ){assert(0) ;}\
 template<> void wxStringWriteValue(wxString & , name* const & ){assert(0) ;}\
 template<> const wxTypeInfo* wxGetTypeInfo( name ** ){ static wxClassTypeInfo s_typeInfo(&name::sm_class##name) ; return &s_typeInfo ; }

#define IMPLEMENT_DYNAMIC_CLASS2( name , basename , basename2) \
_IMPLEMENT_DYNAMIC_CLASS2( name , basename , basename2 , "") \
const wxPropertyInfo *name::GetPropertiesStatic() { return (wxPropertyInfo*) NULL ; } \
WX_CONSTRUCTOR_DUMMY( name )

#define IMPLEMENT_DYNAMIC_CLASS2_XTI( name , basename , basename2, unit) \
	_IMPLEMENT_DYNAMIC_CLASS2( name , basename , basename2 , unit) 

// -----------------------------------
// for abstract classes
// -----------------------------------

    // Single inheritance with one base class

#define _IMPLEMENT_ABSTRACT_CLASS(name, basename)                \
 const wxClassInfo* name::sm_classParents##name[] = { &basename::sm_class##basename ,NULL } ; \
 wxObject* wxVariantToObjectConverter##name ( const wxxVariant &data ) { return data.Get<name*>() ; } \
 wxxVariant wxObjectToVariantConverter##name ( wxObject *data ) { return wxxVariant( dynamic_cast<name*> (data)  ) ; } \
 wxClassInfo name::sm_class##name(sm_classParents##name , wxT("") , wxT(#name),   \
            (int) sizeof(name),                              \
            (wxObjectConstructorFn) 0   ,   \
			name::GetPropertiesStatic(),0 , 0 ,     \
			0 , wxVariantToObjectConverter##name , wxObjectToVariantConverter##name);    \
 template<> void wxStringReadValue(const wxString & , name * & ){assert(0) ;}\
 template<> void wxStringWriteValue(wxString & , name* const & ){assert(0) ;}\
 template<> const wxTypeInfo* wxGetTypeInfo( name ** ){ static wxClassTypeInfo s_typeInfo(&name::sm_class##name) ; return &s_typeInfo ; }

#define IMPLEMENT_ABSTRACT_CLASS( name , basename ) \
_IMPLEMENT_ABSTRACT_CLASS( name , basename ) \
const wxPropertyInfo *name::GetPropertiesStatic() { return (wxPropertyInfo*) NULL ; } 

    // Multiple inheritance with two base classes

#define IMPLEMENT_ABSTRACT_CLASS2(name, basename1, basename2)   \
 wxClassInfo name::sm_class##name(wxT(#name), wxT(#basename1),  \
            wxT(#basename2), (int) sizeof(name),                \
            (wxObjectConstructorFn) 0);

#define IMPLEMENT_CLASS IMPLEMENT_ABSTRACT_CLASS
#define IMPLEMENT_CLASS2 IMPLEMENT_ABSTRACT_CLASS2

#endif