MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QStylePlugin Class Reference

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

 #include <QStylePlugin>

Inherits: QObject.

Public Functions

QStylePlugin ( QObject * parent = 0 )
~QStylePlugin ()

Reimplemented Public Functions

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().