Main Page   Modules   Namespace List   Class Hierarchy   Compound List   File List   Namespace Members   Compound Members   Related Pages  

KParts::Factory Class Reference

#include <factory.h>

Inheritance diagram for KParts::Factory:

KLibFactory KParts::GenericFactory< T > List of all members.

Public Methods

Part * createPart (QWidget *parentWidget=0, const char *widgetName=0, QObject *parent=0, const char *name=0, const char *classname="KParts::Part", const QStringList &args=QStringList())

Protected Methods

virtual Part * createPartObject (QWidget *parentWidget=0, const char *widgetName=0, QObject *parent=0, const char *name=0, const char *classname="KParts::Part", const QStringList &args=QStringList())=0
virtual QObject * createObject (QObject *parent=0, const char *name=0, const char *classname="QObject", const QStringList &args=QStringList())

Detailed Description

A generic factory object to create a Part.

Factory is an abstract class. Reimplement the createPartObject() method to give it functionality.

See also:
KLibFactory.

Definition at line 40 of file factory.h.

Member Function Documentation

virtual QObject* KParts::Factory::createObject (  QObject *    parent = 0,
const char *    name = 0,
const char *    classname = "QObject",
const QStringList &    args = QStringList()
)  [protected, virtual]
 

Reimplemented from KLibFactory. Calls createPart()

Implements KLibFactory.

Part* KParts::Factory::createPart (  QWidget *    parentWidget = 0,
const char *    widgetName = 0,
QObject *    parent = 0,
const char *    name = 0,
const char *    classname = "KParts::Part",
const QStringList &    args = QStringList()
) 
 

Creates a part.

The QStringList can be used to pass additional arguments to the part. If the part needs additional arguments, it should take them as name="value" pairs. This is the way additional arguments will get passed to the part from eg. khtml. You can for example emebed the part into HTML by using the following code: 

    <object type="my_mimetype" data="url_to_my_data">
        <param name="name1" value="value1">
        <param name="name2" value="value2">
    </object>
This could result in a call to 
     createPart( parentWidget, name, parentObject, parentName, "Kparts::Part",
                 QStringList("name1="value1"", "name2="value2") );

Returns:
the newly created part.
createPart() automatically emits a signal KLibFactory::objectCreated to tell the library about its newly created object. This is very important for reference counting, and allows unloading the library automatically once all its objects have been destroyed.

virtual Part* KParts::Factory::createPartObject (  QWidget *    parentWidget = 0,
const char *    widgetName = 0,
QObject *    parent = 0,
const char *    name = 0,
const char *    classname = "KParts::Part",
const QStringList &    args = QStringList()
)  [protected, pure virtual]
 

Reimplement this method in your implementation to create the Part.

The QStringList can be used to pass additional arguments to the part. If the part needs additional arguments, it should take them as name="value" pairs. This is the way additional arguments will get passed to the part from eg. khtml. You can for example emebed the part into HTML by using the following code: 

    <object type="my_mimetype" data="url_to_my_data">
        <param name="name1" value="value1">
        <param name="name2" value="value2">
    </object>
This could result in a call to 
     createPart( parentWidget, name, parentObject, parentName, "Kparts::Part",
                 QStringList("name1="value1"", "name2="value2") );

Returns:
the newly created part.

Implemented in KParts::GenericFactory< T >.

The documentation for this class was generated from the following file:
Generated on Wed Aug 13 23:30:36 2003 for kdelibs by doxygen1.2.18