QDesignerCustomWidgetCollectionInterface Class

Description détaillée

Lors de l'implémentation d'un plugin de widget personnalisé, vous le compilez en tant que bibliothèque distincte. Si vous souhaitez inclure plusieurs plugins de widgets personnalisés dans la même bibliothèque, vous devez en outre créer une sous-classe de QDesignerCustomWidgetCollectionInterface.

QDesignerCustomWidgetCollectionInterface contient une seule fonction renvoyant une liste des objets QDesignerCustomWidgetInterface de la collection. Par exemple, si vous disposez de 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 puisse accéder aux widgets personnalisés et les construire. Sans cette macro, Qt Widgets Designer ne peut en aucun cas les utiliser.