QExtensionManager Class

Detaillierte Beschreibung

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

Die Registrierung einer Erweiterungsfabrik erfolgt normalerweise in der Funktion QDesignerCustomWidgetInterface::initialize():

        void MyPlugin::initialize(QDesignerFormEditorInterface *formEditor)
        {
            if (initialized)
                return;

            auto *manager = formEditor->extensionManager();
            Q_ASSERT(manager != nullptr);

            manager->registerExtensions(new MyExtensionFactory(manager),
                                        Q_TYPEID(QDesignerTaskMenuExtension));

            initialized = true;
        }

Der QExtensionManager ist nicht dazu gedacht, direkt instanziiert zu werden. Sie können eine Schnittstelle zum Qt Widgets Designer's Extension Manager mit der QDesignerFormEditorInterface::extensionManager() Funktion abrufen. Ein Zeiger auf Qt Widgets Designer's aktuelles QDesignerFormEditorInterface Objekt (formEditor im obigen Beispiel) wird durch den Parameter der QDesignerCustomWidgetInterface::initialize() Funktion bereitgestellt. Wenn Sie ein benutzerdefiniertes Widget-Plugin implementieren, müssen Sie die Unterklasse QDesignerCustomWidgetInterface verwenden, um Ihr Plugin dem Qt Widgets Designer zur Verfügung zu stellen.

Wenn dann eine Erweiterung benötigt wird, durchläuft der Erweiterungsmanager von Qt Widgets Designer alle registrierten Fabriken und ruft QExtensionFactory::createExtension() für jede auf, bis die erste gefunden wird, die in der Lage ist, die angeforderte Erweiterung für das ausgewählte Objekt zu erstellen. Diese Fabrik wird dann eine Instanz der Erweiterung erstellen.

Es gibt vier Arten von Erweiterungen in Qt Widgets Designer: QDesignerContainerExtension , QDesignerMemberSheetExtension, QDesignerPropertySheetExtension und QDesignerTaskMenuExtension. Qt Widgets Der Designer verhält sich gleich, unabhängig davon, ob die angeforderte Erweiterung mit einem Container, einem Member Sheet, einem Property Sheet oder einem Aufgabenmenü verbunden ist.

Ein vollständiges Beispiel für die Verwendung der Klasse QExtensionManager finden Sie im Beispiel Taskmenü-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.