QDesignerContainerExtension Class

Ausführliche Beschreibung

Qt Widgets Designer-UI-Editors, der die Option zum Einfügen einer Seite vor der aktuellen Seite in ein Objekt zeigt" src="images/containerextension-example.webp" title="Screenshot des Qt Widgets Designer-UI-Editors, der die Option zum Einfügen einer Seite vor der aktuellen Seite in ein Objekt zeigt"/>

Qt Widgets ContainerExtension bietet eine Schnittstelle zum Erstellen benutzerdefinierter Container-Erweiterungen. Eine Container-Erweiterung besteht aus einer Sammlung von Funktionen, die Designer zur Verwaltung eines mehrseitigen Container-Plugins benötigt, sowie aus einer Liste der Seiten des Containers.

Um eine Container-Erweiterung zu erstellen, muss Ihre Erweiterungsklasse sowohl von ` QObject ` als auch von `QDesignerContainerExtension` erben. Zum Beispiel:

class MyContainerExtension : public QObject,
       public QDesignerContainerExtension
{
    Q_OBJECT
    Q_INTERFACES(QDesignerContainerExtension)

public:
    MyContainerExtension(MyCustomWidget *widget,
                         QObject *parent = 0);
    int count() const;
    QWidget *widget(int index) const;
    int currentIndex() const;
    void setCurrentIndex(int index);
    void addWidget(QWidget *widget);
    void insertWidget(int index, QWidget *widget);
    void remove(int index);

private:
    MyCustomWidget *myWidget;
};

Da wir eine Schnittstelle implementieren, müssen wir sicherstellen, dass diese dem Metaobjektsystem mithilfe des Makros ` Q_INTERFACES()` bekannt gemacht wird. Dies ermöglicht es dem „ Qt Widgets “-Designer, die Funktion ` qobject_cast()` zu verwenden, um mithilfe eines reinen ` QObject `-Zeigers nach unterstützten Schnittstellen abzufragen.

Sie müssen mehrere Funktionen neu implementieren, damit der „ Qt Widgets Designer“ ein benutzerdefiniertes mehrseitiges Container-Widget verwalten kann: Der „ Qt Widgets Designer“ verwendet „ count()“, um die Anzahl der Seiten in Ihrem Container zu verfolgen, „ widget()“, um die Seite an einem bestimmten Index in der Liste der Containerseiten zurückzugeben, und „ currentIndex()“, um den Listenindex der ausgewählten Seite zurückzugeben. „ Qt Widgets “ Der Designer verwendet die Funktion „ addWidget()“, um eine bestimmte Seite zum Container hinzuzufügen, wobei erwartet wird, dass diese an das Ende der Seitenliste angehängt wird, während die Funktion „ insertWidget()“ eine bestimmte Seite durch Einfügen an einem bestimmten Index in den Container einfügt.

Im „ Qt Widgets “-Designer werden die Erweiterungen erst dann erstellt, wenn sie benötigt werden. Aus diesem Grund müssen Sie auch eine ` QExtensionFactory` erstellen, d. h. eine Klasse, die eine Instanz Ihrer Erweiterung erstellen kann, und diese mithilfe des ` Qt Widgets `-Designers unter ` extension manager` registrieren.

Wenn eine Container-Erweiterung benötigt wird, durchläuft die „ extension manager “ des „ Qt Widgets “-Designers alle registrierten Fabriken und ruft für jede davon „ QExtensionFactory::createExtension()“ auf, bis die erste gefunden wird, die eine Container-Erweiterung erstellen kann. Diese Fabrik erstellt dann die Erweiterung für das Plugin.

Im „ Qt Widgets Designer“ stehen vier Arten von Erweiterungen zur Verfügung: „QDesignerContainerExtension“, „ QDesignerMemberSheetExtension “, „ QDesignerPropertySheetExtension “ und „ QDesignerTaskMenuExtension “. Das Verhalten des „ Qt Widgets Designers“ ist unabhängig davon, ob die angeforderte Erweiterung mit einem mehrseitigen Container, einem Elementblatt, einem Eigenschaftsblatt oder einem Aufgabenmenü verknüpft ist.

Die Klasse „ QExtensionFactory “ stellt eine Standard-Erweiterungsfabrik bereit und kann auch als Schnittstelle für benutzerdefinierte Erweiterungsfabriken verwendet werden. Sie können entweder eine neue „ QExtensionFactory “-Instanz erstellen und die Funktion „ QExtensionFactory::createExtension()“ neu implementieren. Beispiel:

QObject *ANewExtensionFactory::createExtension(QObject *object,
        const QString &iid, QObject *parent) const
{
    if (iid != Q_TYPEID(QDesignerContainerExtension))
        return 0;

    if (MyCustomWidget *widget = qobject_cast<MyCustomWidget*>
           (object))
        return new MyContainerExtension(widget, parent);

    return 0;
}

Oder Sie können eine vorhandene Factory verwenden und die Funktion ` QExtensionFactory::createExtension()` erweitern, damit die Factory auch eine Container-Erweiterung erstellen kann. Beispiel:

QObject *AGeneralExtensionFactory::createExtension(QObject *object,
        const QString &iid, QObject *parent) const
{
    MyCustomWidget *widget = qobject_cast<MyCustomWidget*>(object);

    if (widget && (iid == Q_TYPEID(QDesignerTaskMenuExtension))) {
        return new MyTaskMenuExtension(widget, parent);

    } else if (widget && (iid == Q_TYPEID(QDesignerContainerExtension))) {
        return new MyContainerExtension(widget, parent);

    } else {
        return 0;
    }
}

Ein vollständiges Beispiel zur Verwendung der Klasse `QDesignerContainerExtension` finden Sie im Beispiel „Container-Erweiterung“. Das Beispiel zeigt, wie Sie ein benutzerdefiniertes mehrseitiges Plugin für den ` Qt Widgets Designer` erstellen.