QIconEnginePlugin Class | Qt GUI 5.12.8

- Qt 5.12
- Qt GUI
- C++ Classes
- QIconEnginePlugin
- Qt 5.12.8 Reference Documentation

# QIconEnginePlugin Class

The QIconEnginePlugin class provides an abstract base for custom QIconEngine plugins. More...

Header: | #include <QIconEnginePlugin>
qmake: | QT += gui
Inherits: | QObject

- List of all members, including inherited members
- Obsolete members

## Public Functions

| QIconEnginePlugin(QObject *parent = nullptr)
virtual | ~QIconEnginePlugin()
virtual QIconEngine * | create(const QString &filename = QString()) = 0

- 31 public functions inherited from QObject

## Static Public Members

const QMetaObject | staticMetaObject

- 9 static public members inherited from QObject

### Additional Inherited Members

- 1 property inherited from QObject
- 1 public slot inherited from QObject
- 2 signals inherited from QObject
- 9 protected functions inherited from QObject

## Detailed Description

The QIconEnginePlugin class provides an abstract base for custom QIconEngine plugins.

The icon engine plugin is a simple plugin interface that makes it easy to create custom icon engines that can be loaded dynamically into applications through QIcon. QIcon uses the file or resource name's suffix to determine what icon engine to use.

Writing a icon engine plugin is achieved by subclassing this base class, reimplementing the pure virtual function create(), and exporting the class with the Q_PLUGIN_METADATA() macro.

The json metadata should contain 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.

     { "Keys": [ "myiconengine" ] }

See also How to Create Qt Plugins.

## Member Function Documentation

### QIconEnginePlugin::QIconEnginePlugin(QObject *parent = nullptr)

Constructs a icon engine plugin with the given parent. This is invoked automatically by the plugin loader.

### `[virtual]` QIconEnginePlugin::~QIconEnginePlugin()

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]` QIconEngine *QIconEnginePlugin::create(const QString &filename = QString())

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