QDesignerCustomWidgetCollectionInterface Class

Descripción detallada

Cuando se implementa un plugin de widget personalizado, se construye como una librería separada. Si quieres incluir varios plugins de widgets personalizados en la misma librería, debes además subclasificar QDesignerCustomWidgetCollectionInterface.

QDesignerCustomWidgetCollectionInterface contiene una única función que devuelve una lista de los objetos QDesignerCustomWidgetInterface de la colección. Por ejemplo, si tienes varios widgets personalizados CustomWidgetOne, CustomWidgetTwo y CustomWidgetThree, la definición de la clase puede tener este aspecto:

#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;
};

En el constructor de la clase añades las interfaces de tus widgets personalizados a la lista que devuelves en la función 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;
}

Ten en cuenta que en lugar de exportar cada plugin de widget personalizado utilizando la macro Q_PLUGIN_METADATA(), exportas toda la colección. La macro Q_PLUGIN_METADATA() garantiza que Qt Widgets Designer pueda acceder a los widgets personalizados y construirlos. Sin esta macro, no hay forma de que Qt Widgets Designer los utilice.