Home · All Classes · Main Classes · Grouped Classes · Modules · Functions

QStylePlugin Class Reference
^{[QtGui module]}

The QStylePlugin class provides an abstract base for custom QStyle plugins. More...

#include <QStylePlugin>

Inherits QObject.

• List of all members, including inherited members

Public Functions

• QStylePlugin ( QObject * parent = 0 )
• ~QStylePlugin ()
• virtual QStyle * create ( const QString & key ) = 0
• virtual QStringList keys () const = 0

• 28 public functions inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public slot inherited from QObject
• 1 signal inherited from QObject
• 4 static public members inherited from QObject
• 7 protected functions inherited from QObject

Detailed Description

The QStylePlugin class provides an abstract base for custom QStyle plugins.

The style plugin is a simple plugin interface that makes it easy to create custom styles that can be loaded dynamically into applications with a QStyleFactory.

Writing a style plugin is achieved by subclassing this base class, reimplementing the pure virtual functions keys() and create(), and exporting the class with the Q_EXPORT_PLUGIN2() macro.

See also How to Create Qt Plugins.

Member Function Documentation

QStylePlugin::QStylePlugin ( QObject * parent = 0 )

Constructs a style plugin with parent parent. This is invoked automatically by the Q_EXPORT_PLUGIN2() macro.

QStylePlugin::~QStylePlugin ()

Destroys the style plugin.

You never have to call this explicitly. Qt destroys a plugin automatically when it is no longer used.

QStyle * QStylePlugin::create ( const QString & key )   [pure virtual]

Creates and returns a QStyle object for the style key key. The style key is usually the class name of the required style. Keys are case insensitive.

Example:

    QStringList MyStylePlugin::keys() const
    {
        return QStringList() << "Rocket" << "StarBuster";
    }

    QStyle *MyStylePlugin::create(const QString &key)
    {
        QString lcKey = key;
        if (lcKey == "rocket") {
            return new RocketStyle;
        } else if (lcKey == "starbuster") {
            return new StarBusterStyle;
        }
        return 0;
    }

See also keys().

QStringList QStylePlugin::keys () const   [pure virtual]

Returns the list of style keys this plugin supports.

These keys are usually the class names of the custom styles that are implemented in the plugin.

See also create().