QDecorationPlugin Class Reference
^{[QtGui module]}

Detailed Description

The QDecorationPlugin class is an abstract base class for window decoration plugins in Qtopia Core.

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