QIconEnginePluginV2 Class

The QIconEnginePluginV2 class provides an abstract base for custom QIconEngineV2 plugins. More...

Header: #include <QIconEnginePluginV2>
Since: Qt 4.3
Inherits: QObject

Public Functions

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

Reimplemented Public Functions

virtual QIconEngineV2 * create(const QString & filename = QString()) = 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 QIconEnginePluginV2 class provides an abstract base for custom QIconEngineV2 plugins.

Icon engine plugins produces QIconEngines for QIcons; an icon engine is used to render the icon. The keys that identifies the engines the plugin can create are suffixes of icon filenames; they are returned by keys(). The create() function receives the icon filename to return an engine for; it should return 0 if it cannot produce an engine for the file.

Writing an icon engine plugin is achieved by inheriting QIconEnginePluginV2, reimplementing keys() and create(), and adding the Q_EXPORT_PLUGIN2() macro.

You should ensure that you do not duplicate keys. Qt will query the plugins for icon engines in the order in which the plugins are found during plugin search (see the plugins overview document).

See also How to Create Qt Plugins.

Member Function Documentation

QIconEnginePluginV2::QIconEnginePluginV2(QObject * parent = 0)

Constructs a icon engine plugin with the given parent. This is invoked automatically by the Q_EXPORT_PLUGIN2() macro.

QIconEnginePluginV2::~QIconEnginePluginV2()

Destroys the icon engine plugin.

You never have to call this explicitly. Qt destroys a plugin automatically when it is no longer used.

[pure virtual] QIconEngineV2 * QIconEnginePluginV2::create(const QString & filename = QString())

Creates and returns a QIconEngine object for the icon with the given filename.

See also keys().

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

Returns a list of icon engine keys that this plugin supports. The keys correspond to the suffix of the file or resource name used when the plugin was created. Keys are case insensitive.

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.