KGenericFactory< Product, ParentType > Class Template Reference

#include <KGenericFactory>

Inheritance diagram for KGenericFactory< Product, ParentType >:

Public Member Functions
	KGenericFactory (const char *componentName=0, const char *catalogName=0)
	KGenericFactory (const KAboutData *data)
Public Member Functions inherited from KGenericFactoryBase< Product >
	KGenericFactoryBase (const char *componentName, const char *catalogName)
	KGenericFactoryBase (const KAboutData *data)
virtual	~KGenericFactoryBase ()
Public Member Functions inherited from KPluginFactory
	KPluginFactory (const char *componentName=0, const char *catalogName=0, QObject *parent=0)
	KPluginFactory (const KAboutData &aboutData, QObject *parent=0)
KDE_CONSTRUCTOR_DEPRECATED	KPluginFactory (const KAboutData *aboutData, QObject *parent=0)
KDE_CONSTRUCTOR_DEPRECATED	KPluginFactory (QObject *parent)
virtual	~KPluginFactory ()
KComponentData	componentData () const
template<typename T >
T *	create (QObject *parent=0, const QVariantList &args=QVariantList())
template<typename T >
T *	create (const QString &keyword, QObject *parent=0, const QVariantList &args=QVariantList())
template<typename T >
T *	create (QWidget *parentWidget, QObject *parent, const QString &keyword=QString(), const QVariantList &args=QVariantList())
template<typename T >
T *	create (QObject *parent, const QStringList &args)
QObject *	create (QObject *parent=0, const char *classname="QObject", const QStringList &args=QStringList())
Public Member Functions inherited from QObject
	QObject (QObject *parent)
	QObject (QObject *parent, const char *name)
virtual	~QObject ()
bool	blockSignals (bool block)
QObject *	child (const char *objName, const char *inheritsClass, bool recursiveSearch) const
const QObjectList &	children () const
const char *	className () const
bool	connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const
void	deleteLater ()
void	destroyed (QObject *obj)
bool	disconnect (const QObject *receiver, const char *method)
bool	disconnect (const char *signal, const QObject *receiver, const char *method)
void	dumpObjectInfo ()
void	dumpObjectTree ()
QList< QByteArray >	dynamicPropertyNames () const
virtual bool	event (QEvent *e)
virtual bool	eventFilter (QObject *watched, QEvent *event)
T	findChild (const QString &name) const
QList< T >	findChildren (const QRegExp &regExp) const
QList< T >	findChildren (const QString &name) const
bool	inherits (const char *className) const
void	insertChild (QObject *object)
void	installEventFilter (QObject *filterObj)
bool	isA (const char *className) const
bool	isWidgetType () const
void	killTimer (int id)
virtual const QMetaObject *	metaObject () const
void	moveToThread (QThread *targetThread)
const char *	name () const
const char *	name (const char *defaultName) const
QString	objectName () const
QObject *	parent () const
QVariant	property (const char *name) const
void	removeChild (QObject *object)
void	removeEventFilter (QObject *obj)
void	setName (const char *name)
void	setObjectName (const QString &name)
void	setParent (QObject *parent)
bool	setProperty (const char *name, const QVariant &value)
bool	signalsBlocked () const
int	startTimer (int interval)
QThread *	thread () const

Protected Member Functions
virtual QObject *	createObject (QObject *parent, const char *className, const QStringList &args)
Protected Member Functions inherited from KGenericFactoryBase< Product >
virtual KComponentData *	createComponentData ()
Protected Member Functions inherited from KPluginFactory
	KPluginFactory (KPluginFactoryPrivate &dd, QObject *parent=0)
virtual QObject *	create (const char *iface, QWidget *parentWidget, QObject *parent, const QVariantList &args, const QString &keyword)
virtual KParts::Part *	createPartObject (QWidget *parentWidget, QObject *parent, const char *classname, const QStringList &args)
template<class T >
void	registerPlugin (const QString &keyword=QString(), CreateInstanceFunction instanceFunction=InheritanceChecker< T >().createInstanceFunction(reinterpret_cast< T * >(0)))
void	setComponentData (const KComponentData &componentData)
virtual void	setupTranslations ()
QVariantList	stringListToVariantList (const QStringList &list)
QStringList	variantListToStringList (const QVariantList &list)
Protected Member Functions inherited from QObject
bool	checkConnectArgs (const char *signal, const QObject *object, const char *method)
virtual void	childEvent (QChildEvent *event)
virtual void	connectNotify (const char *signal)
virtual void	customEvent (QEvent *event)
virtual void	disconnectNotify (const char *signal)
int	receivers (const char *signal) const
QObject *	sender () const
int	senderSignalIndex () const
virtual void	timerEvent (QTimerEvent *event)

Additional Inherited Members
Signals inherited from KPluginFactory
void	objectCreated (QObject *object)
Static Public Member Functions inherited from KGenericFactoryBase< Product >
static KComponentData	componentData ()
Static Public Member Functions inherited from QObject
bool	connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
bool	connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
bool	disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
bool	disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
QString	tr (const char *sourceText, const char *disambiguation, int n)
QString	trUtf8 (const char *sourceText, const char *disambiguation, int n)
Protected Types inherited from KPluginFactory
typedef QObject *(*	CreateInstanceFunction )(QWidget *, QObject *, const QVariantList &)
Static Protected Member Functions inherited from KPluginFactory
template<class impl , class ParentType >
static QObject *	createInstance (QWidget *parentWidget, QObject *parent, const QVariantList &args)
template<class impl >
static QObject *	createPartInstance (QWidget *parentWidget, QObject *parent, const QVariantList &args)
Static Protected Member Functions inherited from QObject
QByteArray	normalizeSignalSlot (const char *signalSlot)
Protected Attributes inherited from KPluginFactory
KPluginFactoryPrivate *const	d_ptr
Properties inherited from QObject
	objectName
Related Functions inherited from KPluginFactory
#define	K_PLUGIN_FACTORY(name, pluginRegistrations)   K_PLUGIN_FACTORY_WITH_BASEFACTORY(name, KPluginFactory, pluginRegistrations)
#define	K_PLUGIN_FACTORY_DECLARATION(name)   K_PLUGIN_FACTORY_DECLARATION_WITH_BASEFACTORY(name, KPluginFactory)
#define	K_PLUGIN_FACTORY_DEFINITION(name, pluginRegistrations)   K_PLUGIN_FACTORY_DEFINITION_WITH_BASEFACTORY(name, KPluginFactory, pluginRegistrations)

Detailed Description

template<class Product, class ParentType = QObject>
class KGenericFactory< Product, ParentType >

This template provides a generic implementation of a KLibFactory , for use with shared library components.

It implements the pure virtual createObject method of KLibFactory and instantiates objects of the specified class (template argument) when the class name argument of createObject matches a class name in the given hierarchy.

In case you are developing a KParts component, skip this file and go directly to KParts::GenericFactory .

Note that the class specified as template argument needs to provide a certain constructor:

• If the class is derived from QObject then it needs to have a constructor like: MyClass( QObject *parent, const QStringList &args );
• If the class is derived from QWidget then it needs to have a constructor like: MyWidget( QWidget *parent, const QStringList &args);
• If the class is derived from KParts::Part then it needs to have a constructor like: MyPart( QWidget *parentWidget, QObject *parent, const QStringList &args );

The args QStringList passed to the constructor is the args string list that the caller passed to KLibFactory's create method.

In addition upon instantiation this template provides a central KComponentData object for your component, accessible through the static componentData() method. The componentName and catalogName arguments of the KGenericFactory constructor are passed to the KComponentData object.

The creation of the KComponentData object can be customized by inheriting from this template class and re-implementing the virtual createComponentData method. For example it could look like this:

KComponentData *MyFactory::createComponentData()
{
    return new KComponentData( myAboutData );
}

Example of usage of the whole template:

class MyPlugin : public KParts::Plugin
{
    Q_ OBJECT
public:
    MyPlugin( QObject *parent, const QStringList &args );
    ...
};

K_EXPORT_COMPONENT_FACTORY( libmyplugin, KGenericFactory<MyPlugin> )

Deprecated:

use KPluginFactory

It implements the pure virtual createObject method of KLibFactory and instantiates objects of the specified classes in the given typelist template argument when the class name argument of createObject matches a class names in the given hierarchy of classes.

Note that each class in the specified in the typelist template argument needs to provide a certain constructor:

• If the class is derived from QObject then it needs to have a constructor like: MyClass( QObject *parent, const QStringList &args );
• If the class is derived from QWidget then it needs to have a constructor like: MyWidget( QWidget *parent, const QStringList &args);
• If the class is derived from KParts::Part then it needs to have a constructor like: MyPart( QWidget *parentWidget, QObject *parent, const QStringList &args );

The args QStringList passed to the constructor is the args string list that the caller passed to KLibFactory's create method.

In addition upon instantiation this template provides a central KComponentData object for your component, accessible through the static componentData() method. The componentName and catalogName arguments of the KGenericFactory constructor are passed to the KComponentData object.

The creation of the KComponentData object can be customized by inheriting from this template class and re-implementing the virtual createComponentData method. For example it could look like this:

KComponentData *MyFactory::createComponentData()
{
    return new KComponentData( myAboutData );
}

Example of usage of the whole template:

class MyPlugin : public KParts::Plugin
{
    Q_ OBJECT
public:
    MyPlugin( QObject *parent,
              const QStringList &args );
    ...
};

class MyDialogComponent : public KDialog
{
    Q_ OBJECT
public:
    MyDialogComponent( QWidget *parentWidget,
                       const QStringList &args );
    ...
};

typedef K_TYPELIST_2( MyPlugin, MyDialogComponent ) Products;
K_EXPORT_COMPONENT_FACTORY( libmyplugin, KGenericFactory<Products> )

It implements the pure virtual createObject method of KLibFactory and instantiates objects of the specified classes in the given typelist template argument when the class name argument of createObject matches a class names in the given hierarchy of classes.

Note that each class in the specified in the typelist template argument needs to provide a certain constructor:

• If the class is derived from QObject then it needs to have a constructor like: MyClass( QObject *parent, const QStringList &args );
• If the class is derived from QWidget then it needs to have a constructor like: MyWidget( QWidget *parent, const QStringList &args);
• If the class is derived from KParts::Part then it needs to have a constructor like: MyPart( QWidget *parentWidget, QObject *parent, const QStringList &args );

The args QStringList passed to the constructor is the args string list that the caller passed to KLibFactory's create method.

In addition upon instantiation this template provides a central KComponentData object for your component, accessible through the static componentData() method. The componentName and catalogNames arguments of the KGenericFactory constructor are passed to the KComponentData object.

The creation of the KComponentData object can be customized by inheriting from this template class and re-implementing the virtual createComponentData method. For example it could look like this:

KComponentData *MyFactory::createComponentData()
{
    return new KComponentData( myAboutData );
}

Example of usage of the whole template:

class MyPlugin : public KParts::Plugin
{
    Q_ OBJECT
public:
    MyPlugin( QObject *parent,
              const QStringList &args );
    ...
};

class MyDialogComponent : public KDialog
{
    Q_ OBJECT
public:
    MyDialogComponent( QWidget *parentWidget,
                       const QStringList &args );
    ...
};

typedef K_TYPELIST_2( MyPlugin, MyDialogComponent ) Products;
K_EXPORT_COMPONENT_FACTORY( libmyplugin, KGenericFactory<Products> )

Definition at line 152 of file kgenericfactory.h.

Constructor & Destructor Documentation

template<class Product , class ParentType = QObject>

KGenericFactory< Product, ParentType >::KGenericFactory ( const char *  componentName = 0, const char *  catalogName = 0  )

inlineexplicit

Definition at line 155 of file kgenericfactory.h.

template<class Product , class ParentType = QObject>

KGenericFactory< Product, ParentType >::KGenericFactory ( const KAboutData *  data )

inlineexplicit

Definition at line 159 of file kgenericfactory.h.

Member Function Documentation

template<class Product , class ParentType = QObject>

virtual QObject* KGenericFactory< Product, ParentType >::createObject ( QObject *  parent, const char *  className, const QStringList &  args  )

inlineprotectedvirtual

Deprecated:

Reimplemented from KPluginFactory.

Definition at line 164 of file kgenericfactory.h.

---

The documentation for this class was generated from the following file:

• kgenericfactory.h