QDesignerPropertySheetExtension Class

Detaillierte Beschreibung

QDesignerPropertySheetExtension stellt eine Sammlung von Funktionen zur Verfügung, die typischerweise verwendet werden, um die Eigenschaften eines Widgets abzufragen und das Aussehen der Eigenschaften im Eigenschaftseditor zu verändern. Zum Beispiel:

QDesignerPropertySheetExtension *propertySheet = nullptr;
QExtensionManager manager = formEditor->extensionManager();

propertySheet = qt_extension<QDesignerPropertySheetExtension*>(manager, widget);
int index = propertySheet->indexOf(u"margin"_s);

propertySheet->setProperty(index, 10);
propertySheet->setChanged(index, true);

delete propertySheet;

Beachten Sie, dass, wenn Sie den Wert einer Eigenschaft mit der Funktion QDesignerPropertySheetExtension::setProperty() ändern, der Rückgängig-Stapel nicht aktualisiert wird. Um sicherzustellen, dass der Wert einer Eigenschaft mit Hilfe des Rückgängig-Stapels rückgängig gemacht werden kann, müssen Sie stattdessen die Funktion QDesignerFormWindowCursorInterface::setProperty() oder ihren Verwandten setWidgetProperty() verwenden.

Bei der Implementierung eines benutzerdefinierten Widget-Plugins wird ein Zeiger auf das aktuelle QDesignerFormEditorInterface -Objekt von Qt Widgets Designer (formEditor im obigen Beispiel) durch den Parameter der Funktion QDesignerCustomWidgetInterface::initialize() bereitgestellt.

Das Eigenschaftsblatt oder jede andere Erweiterung kann durch Abfragen des Qt Widgets Designer Erweiterungsmanagers mit der Funktion qt_extension() abgerufen werden. Wenn Sie die Erweiterung freigeben wollen, müssen Sie nur den Zeiger löschen.

Alle Widgets haben ein Standardeigenschaftsblatt, das den Eigenschaftseditor von Qt Widgets Designer mit den Eigenschaften des Widgets füllt (d.h. mit denen, die mit dem Makro Q_PROPERTY() definiert wurden). Aber QDesignerPropertySheetExtension bietet auch eine Schnittstelle zum Erstellen von benutzerdefinierten Eigenschaftsblatterweiterungen.

Beachten Sie dabei die folgenden Einschränkungen:

• Qt Widgets Designer verwendet die QDesignerPropertySheetExtension, um seinen Eigenschaftseditor zu füttern. Immer wenn ein Widget in seinem Arbeitsbereich ausgewählt wird, fragt Qt Widgets Designer nach der Property Sheet Extension des Widgets. Wenn das ausgewählte Widget eine implementierte Eigenschaftsblatt-Erweiterung hat, überschreibt diese Erweiterung das Standard-Eigenschaftsblatt.
• Die Datentypen, die vom Eigenschaftsblatt für einige Eigenschaften verwendet werden, sind undurchsichtige benutzerdefinierte QVariant Typen, die zusätzliche Informationen anstelle von einfachen Qt-Datentypen enthalten. Dies ist zum Beispiel der Fall bei Aufzählungen, Flags, Icons, Pixmaps und Strings.
• Qt Widgets Der Eigenschaftseditor des Designers hat keine Implementierung für die Handhabung von Q_PROPERTY Typen für benutzerdefinierte Typen, die mit Q_DECLARE_METATYPE() deklariert wurden.

Um eine Eigenschaftsblatt-Erweiterung zu erstellen, muss Ihre Erweiterungsklasse sowohl von QObject als auch von QDesignerPropertySheetExtension erben. Da wir eine Schnittstelle implementieren, müssen wir sicherstellen, dass sie dem Meta-Objektsystem mit dem Makro Q_INTERFACES() bekannt gemacht wird:

class MyPropertySheetExtension : public QObject,
        public QDesignerPropertySheetExtension
{
    Q_OBJECT
    Q_INTERFACES(QDesignerPropertySheetExtension)

public:
    ...
}

Dadurch kann Qt Widgets Designer qobject_cast() verwenden, um nach unterstützten Schnittstellen zu suchen, wobei nichts weiter als ein QObject -Zeiger verwendet wird.

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

Wenn eine Eigenschaftsblatt-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 Eigenschaftsblatt-Erweiterung für das ausgewählte Widget zu erstellen. Diese Fabrik wird dann eine Instanz der Erweiterung erstellen. Wenn keine solche Fabrik gefunden wird, verwendet Qt Widgets Designer das Standard-Eigenschaftsblatt.

Es gibt vier Arten von Erweiterungen in Qt Widgets Designer: QDesignerContainerExtension, QDesignerMemberSheetExtension, QDesignerPropertySheetExtension und QDesignerTaskMenuExtension. Qt Designer verhält sich 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(QDesignerPropertySheetExtension))
        return 0;

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

    return 0;
}

Oder Sie können eine bestehende Fabrik verwenden und die Funktion QExtensionFactory::createExtension() erweitern, damit die Fabrik auch eine Eigenschaftsblatt-Erweiterung erstellen kann. 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(QDesignerPropertySheetExtension))) {
        return new MyPropertySheetExtension(widget, parent);

    } else {
        return 0;
    }
}

Ein vollständiges Beispiel für die Verwendung einer Erweiterungsklasse finden Sie im Beispiel Aufgabenmenüerweiterung. Das Beispiel zeigt, wie Sie ein benutzerdefiniertes Widget-Plugin für Qt Designer erstellen und wie Sie die Klasse QDesignerTaskMenuExtension verwenden, um benutzerdefinierte Elemente zum Aufgabenmenü von Qt Widgets Designer hinzuzufügen.