Класс QStylePlugin

Класс QStylePlugin предоставляет абстрактную базу для пользовательских плагинов QStyle. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Подробное описание

QStylePlugin — это простой интерфейс плагина, который упрощает создание пользовательских стилей, которые могут быть динамически загружены в приложения с помощью класса QStyleFactory.

Для создания плагина стиля необходимо создать подкласс этого базового класса, переопределить чисто виртуальную функцию create() и экспортировать класс с помощью макроса Q_PLUGIN_METADATA().

class MyStylePlugin : public QStylePlugin
{
    Q_OBJECT
    Q_PLUGIN_METADATA(IID "org.qt-project.Qt.QStyleFactoryInterface" FILE "mystyleplugin.json")
public:
    MyStylePlugin(QObject *parent = 0);

    QStyle *create(const QString &key) override;
};

Файл метаданных json mystyleplugin.json для плагина должен содержать информацию о названиях стилей, которые поддерживает плагин, следующим образом:

{ "Keys": [ "Rocket", "Starbuster" ] }

Подробности см. в разделе Как создать плагины Qt.

См. также QStyleFactory и QStyle.

Документация по функциям-членам

QStylePlugin::QStylePlugin(QObject *parent = nullptr)

Создаёт плагин стиля с заданным parent.

Обратите внимание, что этот конструктор вызывается автоматически сгенерированным кодом moc для экспорта плагина, поэтому нет необходимости вызывать его явно.

[virtual] QStylePlugin::~QStylePlugin()

Удаляет плагин стиля.

Обратите внимание, что Qt автоматически удаляет плагин, когда он больше не используется, поэтому нет необходимости вызывать деструктор явно.

[pure virtual] QStyle *QStylePlugin::create(const QString &key)

Создаёт и возвращает объект QStyle для заданного ключа стиля key. Если плагин не может создать стиль, он должен вернуть 0.

Ключ стиля обычно представляет собой имя класса требуемого стиля. Обратите внимание, что ключи нечувствительны к регистру. Например:

QStyle *MyStylePlugin::create(const QString &key)
{
    QString lcKey = key.toLower();
    if (lcKey == "rocket") {
        return new RocketStyle;
    } else if (lcKey == "starbuster") {
        return new StarBusterStyle;
    }
    return 0;
}