Класс QDesignerCustomWidgetCollectionInterface

Класс QDesignerCustomWidgetCollectionInterface позволяет включать несколько пользовательских виджетов в одну библиотеку. Подробнее...

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

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

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

При реализации плагина пользовательского виджета, он создаётся как отдельная библиотека. Если вы хотите включить несколько плагинов пользовательских виджетов в одну библиотеку, необходимо дополнительно унаследовать класс QDesignerCustomWidgetCollectionInterface.

QDesignerCustomWidgetCollectionInterface содержит единственную функцию, возвращающую список объектов QDesignerCustomWidgetInterface коллекции. Например, если у вас есть несколько пользовательских виджетов CustomWidgetOne, CustomWidgetTwo и CustomWidgetThree, определение класса может выглядеть так:

#include customwidgetoneinterface.h
#include customwidgettwointerface.h
#include customwidgetthreeinterface.h

#include <QtDesigner/qtdesigner.h>
#include <QtCore/qplugin.h>

class MyCustomWidgets: public QObject, public QDesignerCustomWidgetCollectionInterface
{
    Q_OBJECT
    Q_PLUGIN_METADATA(IID "org.qt-project.Qt.QDesignerCustomWidgetCollectionInterface")
    Q_INTERFACES(QDesignerCustomWidgetCollectionInterface)

public:
    MyCustomWidgets(QObject *parent = 0);

    QList<QDesignerCustomWidgetInterface*> customWidgets() const override;

private:
    QList<QDesignerCustomWidgetInterface*> widgets;
};

В конструкторе класса вы добавляете интерфейсы к своим пользовательским виджетам в список, который вы возвращаете в функции customWidgets():

MyCustomWidgets::MyCustomWidgets(QObject *parent)
        : QObject(parent)
{
    widgets.append(new CustomWidgetOneInterface(this));
    widgets.append(new CustomWidgetTwoInterface(this));
    widgets.append(new CustomWidgetThreeInterface(this));
}

QList<QDesignerCustomWidgetInterface*> MyCustomWidgets::customWidgets() const
{
    return widgets;
}

Обратите внимание, что вместо экспорта каждого плагина пользовательского виджета с помощью макроса Q_PLUGIN_METADATA(), вы экспортируете всю коллекцию. Макрос Q_PLUGIN_METADATA() гарантирует, что Qt Designer может получить доступ к пользовательским виджетам и создать их. Без этого макроса, Qt Designer не сможет их использовать.

См. также QDesignerCustomWidgetInterface и Создание пользовательских виджетов для Qt Designer.

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

[virtual] QDesignerCustomWidgetCollectionInterface::~QDesignerCustomWidgetCollectionInterface()

Уничтожает интерфейс коллекции пользовательских виджетов.

[pure virtual] QList<QDesignerCustomWidgetInterface *> QDesignerCustomWidgetCollectionInterface::customWidgets() const

Возвращает список интерфейсов к пользовательским виджетам коллекции.