QDesignerCustomWidgetCollectionInterface Class

Ausführliche Beschreibung

Bei der Implementierung eines benutzerdefinierten Widget-Plugins erstellen Sie dieses als separate Bibliothek. Wenn Sie mehrere benutzerdefinierte Widget-Plugins in derselben Bibliothek einbinden möchten, müssen Sie zusätzlich eine Unterklasse von `QDesignerCustomWidgetCollectionInterface` erstellen.

QDesignerCustomWidgetCollectionInterface enthält eine einzige Funktion, die eine Liste der „ QDesignerCustomWidgetInterface “-Objekte der Sammlung zurückgibt. Wenn Sie beispielsweise mehrere benutzerdefinierte Widgets haben – CustomWidgetOne, CustomWidgetTwo und CustomWidgetThree –, könnte die Klassendefinition wie folgt aussehen:

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

Im Klassenkonstruktor fügen Sie die Schnittstellen Ihrer benutzerdefinierten Widgets der Liste hinzu, die Sie in der Funktion ` customWidgets()` zurückgeben:

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

Beachten Sie, dass Sie nicht jedes benutzerdefinierte Widget-Plugin einzeln mit dem Makro „ Q_PLUGIN_METADATA()“ exportieren, sondern die gesamte Sammlung. Das Makro „ Q_PLUGIN_METADATA()“ stellt sicher, dass der „ Qt Widgets Designer“ auf die benutzerdefinierten Widgets zugreifen und diese erstellen kann. Ohne dieses Makro kann der „ Qt Widgets Designer“ sie nicht verwenden.