QDesignerMemberSheetExtension Class

Detaillierte Beschreibung

QDesignerMemberSheetExtension ist eine Sammlung von Funktionen, die typischerweise verwendet werden, um die Member-Funktionen eines Widgets abzufragen und das Erscheinungsbild der Member-Funktionen im Bearbeitungsmodus von Qt Widgets Designer's Signalen und Slots 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 Qt Widgets Designer's aktuelles QDesignerFormEditorInterface Objekt (formEditor im obigen Beispiel) durch den Parameter der Funktion QDesignerCustomWidgetInterface::initialize() bereitgestellt.

Das Mitgliedsblatt (und jede andere Erweiterung) kann durch Abfrage des Erweiterungsmanagers von Qt Widgets Designer 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 Standard-Membersheet, das im Qt Widgets Designer's Signale und Slots Bearbeitungsmodus 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:
    ...
}

Dies ermöglicht Qt Widgets Designer, qobject_cast() zu verwenden, um unterstützte Schnittstellen mit nichts anderem als einem QObject -Zeiger abzufragen.

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.

In Qt Widgets Designer sind vier Arten von Erweiterungen verfügbar: QDesignerContainerExtension, QDesignerMemberSheetExtension, QDesignerPropertySheetExtension und QDesignerTaskMenuExtension. Qt Widgets Designer verhält sich gleich, unabhängig davon, ob die angeforderte Erweiterung mit einem mehrseitigen Container, einem Member Sheet, einem Property Sheet 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.