QDesignerMemberSheetExtension Class

Detaillierte Beschreibung

QDesignerMemberSheetExtension ist eine Sammlung von Funktionen, die typischerweise verwendet werden, um die Member-Funktionen eines Widgets abzufragen und um das Erscheinungsbild der Member-Funktionen im Bearbeitungsmodus der Signale und Slots von Qt Widgets Designer zu manipulieren. Ein Beispiel:

QDesignerMemberSheetExtension *memberSheet = nullptr;
QExtensionManager manager = formEditor->extensionManager();

memberSheet = qt_extension<QDesignerMemberSheetExtension*>(manager, widget);
int index = memberSheet->indexOf(setEchoMode);
memberSheet->setVisible(index, false);

delete memberSheet;

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 Member Sheet (und jede andere Erweiterung) kann durch Abfrage des Qt Widgets Designer's Extension Managers mit der qt_extension() Funktion abgerufen werden. Wenn Sie die Erweiterung freigeben wollen, müssen Sie nur den Zeiger löschen.

Alle Widgets haben ein Standard-Membersheet, das in Qt Widgets Designers Signal- und Slotbearbeitungsmodus mit den Memberfunktionen des Widgets verwendet wird. Aber QDesignerMemberSheetExtension bietet auch eine Schnittstelle zum Erstellen von benutzerdefinierten Member Sheet Erweiterungen.

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

class MyMemberSheetExtension : public QObject,
        public QDesignerMemberSheetExtension
{
    Q_OBJECT
    Q_INTERFACES(QDesignerMemberSheetExtension)

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, wenn Sie eine Member-Sheet-Erweiterung implementieren, 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 die Member-Sheet-Erweiterung eines Widgets 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 Member-Sheet-Erweiterung für dieses Widget zu erstellen. Diese Fabrik wird dann eine Instanz der Erweiterung erstellen. Wenn keine solche Fabrik gefunden wird, verwendet Qt Widgets Designer das Standard-Membersheet.

Es gibt vier verfügbare Typen 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(QDesignerMemberSheetExtension))
        return 0;

    if (MyCustomWidget *widget = qobject_cast<MyCustomWidget*>
           (object))
        return new MyMemberSheetExtension(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 Member-Sheet-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(QDesignerMemberSheetExtension))) {
        return new MyMemberSheetExtension(widget, parent);

    } else {
        return 0;
    }
}

Ein vollständiges Beispiel für die Verwendung einer Erweiterungsklasse finden Sie unter Beispiel für eine 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.