QDesignerCustomWidgetCollectionInterface Class

Description détaillée

Lorsque vous implémentez un plugin de widget personnalisé, vous le construisez comme une bibliothèque séparée. Si vous souhaitez inclure plusieurs plugins de widgets personnalisés dans la même bibliothèque, vous devez en outre sous-classer QDesignerCustomWidgetCollectionInterface.

QDesignerCustomWidgetCollectionInterface contient une seule fonction renvoyant une liste des objets QDesignerCustomWidgetInterface de la collection. Par exemple, si vous avez plusieurs widgets personnalisés CustomWidgetOne, CustomWidgetTwo et CustomWidgetThree, la définition de la classe peut ressembler à ceci :

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

Dans le constructeur de la classe, vous ajoutez les interfaces de vos widgets personnalisés à la liste que vous renvoyez dans la fonction 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;
}

Notez qu'au lieu d'exporter chaque plugin de widget personnalisé à l'aide de la macro Q_PLUGIN_METADATA(), vous exportez l'ensemble de la collection. La macro Q_PLUGIN_METADATA() garantit que Qt Widgets Designer peut accéder aux widgets personnalisés et les construire. Sans cette macro, Qt Widgets Designer ne peut pas les utiliser.