Qt 4.2: QDecorationPlugin Class Reference

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

# QDecorationPlugin Class Reference
[QtGui module]

The QDecorationPlugin class is an abstract base class for window decoration plugins. More...

     #include <QDecorationPlugin>

Inherits QObject.

- List of all members, including inherited members

### Public Functions

- QDecorationPlugin ( QObject * parent = 0 )
- ~QDecorationPlugin ()
- virtual QDecoration * 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 QDecorationPlugin class is an abstract base class for window decoration plugins.

Note that this class is only available in Qtopia Core.

Qtopia Core provides three ready-made decoration styles: `Default`, `Styled` and `Windows`. Custom decorations can be implemented by subclassing the QDecoration class and creating a decoration plugin.

A decoration plugin can be created by subclassing QDecorationPlugin and implementing the pure virtual keys() and create() functions. By exporting the derived class using the Q_EXPORT_PLUGIN2() macro, Qtopia Core's implementation of the QDecorationFactory class will automatically detect the plugin and load the driver into the application at runtime. See How to Create Qt Plugins for details.

To actually apply a decoration, use the QApplication::qwsSetDecoration() function.

See also QDecoration and QDecorationFactory.

## Member Function Documentation

### QDecorationPlugin::QDecorationPlugin ( QObject * parent = 0 )

Constructs a decoration 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.

### QDecorationPlugin::~QDecorationPlugin ()

Destroys the decoration plugin.

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

### QDecoration * QDecorationPlugin::create ( const QString & key ) `[pure virtual]`

Creates a decoration matching the given key. Note that keys are case-insensitive.

See also keys().

### QStringList QDecorationPlugin::keys () const `[pure virtual]`

Returns the list of valid keys, i.e., the decorations supported by this plugin.

See also create().