QDecorationPlugin Class

The QDecorationPlugin class is an abstract base class for window decoration plugins in Qt for Embedded Linux. More...

Header: #include <QDecorationPlugin>
Inherits: QObject

Public Functions

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

Reimplemented Public Functions

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
  • 7 static public members inherited from QObject
  • 8 protected functions inherited from QObject

Detailed Description

The QDecorationPlugin class is an abstract base class for window decoration plugins in Qt for Embedded Linux.

Note that this class is only available in Qt for Embedded Linux.

Qt for Embedded Linux 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, the default implementation of the QDecorationFactory class will automatically detect the plugin and load the driver into the application at run-time. 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.

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

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

See also keys().

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

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

See also create().

© 2016 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.