QDesignerContainerExtension Class

Detaillierte Beschreibung

QDesignerContainerExtension bietet eine Schnittstelle zur Erstellung eigener Container-Erweiterungen. Eine Container-Erweiterung besteht aus einer Sammlung von Funktionen, die Qt Widgets Designer benötigt, um ein mehrseitiges Container-Plugin zu verwalten, und einer Liste der Seiten des Containers.

Um eine Container-Erweiterung zu erstellen, muss Ihre Erweiterungsklasse sowohl von QObject als auch von QDesignerContainerExtension erben. Ein 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 sie dem Meta-Objektsystem mit dem Q_INTERFACES() Makro bekannt gemacht wird. Dadurch kann Qt Widgets Designer die Funktion qobject_cast() verwenden, um nach unterstützten Schnittstellen zu suchen, wobei nichts weiter als ein Zeiger QObject benötigt wird.

Sie müssen mehrere Funktionen neu implementieren, damit Qt Widgets Designer ein benutzerdefiniertes mehrseitiges Container-Widget verwalten kann: 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 Seiten des Containers 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 er erwartet, dass sie an die Liste der Seiten angehängt wird, während er erwartet, dass die Funktion insertWidget() eine bestimmte Seite zum Container hinzufügt, indem sie an einem bestimmten Index eingefügt wird.

In Qt Widgets Designer werden die Erweiterungen erst erstellt, wenn sie benötigt werden. Aus diesem Grund müssen Sie auch eine QExtensionFactory erstellen, d.h. eine Klasse, die in der Lage ist, eine Instanz Ihrer Erweiterung zu erzeugen, und diese mit Qt Widgets Designer's extension manager registrieren.

Wenn eine Container-Erweiterung benötigt wird, durchläuft Qt Widgets Designer's extension manager alle registrierten Fabriken und ruft QExtensionFactory::createExtension() für jede auf, bis die erste gefunden wird, die in der Lage ist, eine Container-Erweiterung zu erstellen. Diese Fabrik wird dann die Erweiterung für das Plugin erstellen.

Es gibt vier verfügbare Arten von Erweiterungen in Qt Widgets Designer: QDesignerContainerExtension , QDesignerMemberSheetExtension, QDesignerPropertySheetExtension und QDesignerTaskMenuExtension. Qt Widgets Das Verhalten des Designers ist gleich, unabhängig davon, ob die angeforderte Erweiterung mit einem mehrseitigen Container, einem Mitgliederblatt, einem Eigenschaftsblatt oder einem Aufgabenmenü verbunden ist.

Die Klasse QExtensionFactory bietet eine Standard-Erweiterungsfabrik und kann auch als Schnittstelle für benutzerdefinierte Erweiterungsfabriken verwendet werden. Sie können entweder eine neue QExtensionFactory erstellen und die Funktion QExtensionFactory::createExtension() neu implementieren. Zum 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 bestehende Fabrik verwenden und die Funktion QExtensionFactory::createExtension() so erweitern, dass die Fabrik in der Lage ist, auch eine Container-Erweiterung zu erstellen. Ein 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 für die Klasse QDesignerContainerExtension finden Sie im Beispiel Container Extension. Das Beispiel zeigt, wie man ein benutzerdefiniertes mehrseitiges Plugin für Qt Widgets Designer erstellt.