Home · All Namespaces · 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

• 29 public functions inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public slot inherited from QObject
• 1 signal inherited from QObject
• 5 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.

QStylePlugin is a simple plugin interface that makes it easy to create custom styles that can be loaded dynamically into applications using the QStyleFactory class.

Writing a style plugin is achieved by subclassing this base class, reimplementing the pure virtual keys() and create() functions, and exporting the class using the Q_EXPORT_PLUGIN2() macro. See How to Create Qt Plugins for details.

See also QStyleFactory and QStyle.

Member Function Documentation

QStylePlugin::QStylePlugin ( QObject * parent = 0 )

Constructs a style plugin with the given parent.

Note that this constructor is invoked automatically by the Q_EXPORT_PLUGIN2() macro, so there is no need for calling it explicitly.

QStylePlugin::~QStylePlugin ()

Destroys the style plugin.

Note that Qt destroys a plugin automatically when it is no longer used, so there is no need for calling the destructor explicitly.

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

Creates and returns a QStyle object for the given style key. If a plugin cannot create a style, it should return 0 instead.

The style key is usually the class name of the required style. Note that the keys are case insensitive. For 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().