QDesignerCustomWidgetCollectionInterface Class

Detaillierte Beschreibung

Wenn Sie ein benutzerdefiniertes Widget-Plugin implementieren, erstellen Sie es als separate Bibliothek. Wenn Sie mehrere benutzerdefinierte Widget-Plugins in dieselbe Bibliothek einbinden wollen, müssen Sie zusätzlich die Unterklasse QDesignerCustomWidgetCollectionInterface verwenden.

QDesignerCustomWidgetCollectionInterface enthält eine einzige Funktion, die eine Liste der QDesignerCustomWidgetInterface Objekte der Sammlung zurückgibt. Wenn Sie zum Beispiel mehrere benutzerdefinierte Widgets CustomWidgetOne, CustomWidgetTwo und CustomWidgetThree haben, kann 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 zu der Liste hinzu, die Sie mit 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 einzelne benutzerdefinierte Widget-Plugin mit dem Makro Q_PLUGIN_METADATA() exportieren, sondern die gesamte Sammlung. Das Makro Q_PLUGIN_METADATA() stellt sicher, dass Qt Widgets Designer auf die benutzerdefinierten Widgets zugreifen und diese erstellen kann. Ohne dieses Makro gibt es keine Möglichkeit für Qt Widgets Designer, sie zu verwenden.