QDesignerCustomWidgetInterface Class

Detaillierte Beschreibung

QDesignerCustomWidgetInterface bietet ein benutzerdefiniertes Widget mit einer Schnittstelle. Die Klasse enthält eine Reihe von Funktionen, die subclassed werden müssen, um grundlegende Informationen über das Widget zurückzugeben, wie z.B. den Klassennamen und den Namen der Header-Datei. Weitere Funktionen müssen implementiert werden, um das Plugin zu initialisieren, wenn es geladen wird, und um Instanzen des benutzerdefinierten Widgets zu erstellen, die Qt Widgets Designer verwenden kann.

Wenn Sie ein benutzerdefiniertes Widget implementieren, müssen Sie die Unterklasse QDesignerCustomWidgetInterface verwenden, um Ihr Widget dem Qt Widgets Designer zur Verfügung zu stellen. Dies ist zum Beispiel die Deklaration für das Plugin, das im Beispiel des benutzerdefinierten Widget-Plugins verwendet wird und die Verwendung eines benutzerdefinierten Analoguhr-Widgets durch Qt Widgets Designer ermöglicht:

class AnalogClockPlugin : public QObject, public QDesignerCustomWidgetInterface
{
    Q_OBJECT
    Q_PLUGIN_METADATA(IID "org.qt-project.Qt.QDesignerCustomWidgetInterface")
    Q_INTERFACES(QDesignerCustomWidgetInterface)
public:
    explicit AnalogClockPlugin(QObject *parent = nullptr);

    bool isContainer() const override;
    bool isInitialized() const override;
    QIcon icon() const override;
    QString domXml() const override;
    QString group() const override;
    QString includeFile() const override;
    QString name() const override;
    QString toolTip() const override;
    QString whatsThis() const override;
    QWidget *createWidget(QWidget *parent) override;
    void initialize(QDesignerFormEditorInterface *core) override;

private:
    bool initialized = false;
};

Beachten Sie, dass der einzige Teil der Klassendefinition, der für dieses spezielle benutzerdefinierte Widget spezifisch ist, der Klassenname ist. Da wir eine Schnittstelle implementieren, müssen wir außerdem sicherstellen, dass sie dem Meta-Objektsystem mit dem Makro Q_INTERFACES() bekannt gemacht wird. Dies ermöglicht es Qt Widgets Designer, die Funktion qobject_cast() zu verwenden, um nach unterstützten Schnittstellen zu suchen, wobei nichts weiter als ein QObject -Zeiger benötigt wird.

Nachdem Qt Widgets Designer ein benutzerdefiniertes Widget-Plugin geladen hat, ruft er die Funktion initialize() der Schnittstelle auf, um ihr zu ermöglichen, alle Ressourcen einzurichten, die sie benötigen könnte. Diese Funktion wird mit einem QDesignerFormEditorInterface -Parameter aufgerufen, der dem Plugin einen Zugang zur gesamten API von Qt Widgets Designer bietet.

Qt Widgets Designer konstruiert Instanzen des benutzerdefinierten Widgets, indem er die Funktion createWidget() des Plugins mit einem geeigneten übergeordneten Widget aufruft. Plugins müssen eine Instanz eines benutzerdefinierten Widgets mit dem angegebenen übergeordneten Widget konstruieren und zurückgeben.

Exportieren Sie Ihr benutzerdefiniertes Widget-Plugin in Qt Widgets Designer, indem Sie das Makro Q_PLUGIN_METADATA() verwenden. Wenn zum Beispiel eine Bibliothek mit dem Namen libcustomwidgetplugin.so (unter Unix) oder libcustomwidget.dll (unter Windows) eine Widget-Klasse mit dem Namen MyCustomWidget enthält, können wir sie exportieren, indem wir die folgende Zeile in die Datei einfügen, die den Plugin-Header enthält:

Q_PLUGIN_METADATA(IID "org.qt-project.Qt.QDesignerCustomWidgetInterface")

Dieses Makro stellt sicher, dass Qt Widgets Designer auf das benutzerdefinierte Widget zugreifen und es konstruieren kann. Ohne dieses Makro gibt es keine Möglichkeit für Qt Widgets Designer, es zu verwenden.

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

• QVariant::ByteArray
• QVariant::Bool
• QVariant::Farbe
• QVariant::Cursor
• QVariant::Datum
• QVariant::DateTime
• QVariant::Double
• QVariant::Int
• QVariant::Punkt
• QVariant::Rect
• QVariant::Größe
• QVariant::SizePolicy
• QVariant::String
• QVariant::Zeit
• QVariant::UInt

Ein vollständiges Beispiel für die Verwendung der Klasse QDesignerCustomWidgetInterface finden Sie unter Custom Widget Example. Das Beispiel zeigt, wie man ein benutzerdefiniertes Widget-Plugin für Qt Widgets Designer erstellt.