QExtensionManager Class

Ausführliche Beschreibung

Im „ Qt Widgets Designer“ werden die Erweiterungen erst dann erstellt, wenn sie benötigt werden. Aus diesem Grund müssen Sie bei der Implementierung einer Erweiterung auch eine „ QExtensionFactory “ erstellen, d. h. eine Klasse, die eine Instanz Ihrer Erweiterung erstellen kann, und diese über den Erweiterungsmanager des „ Qt Widgets Designers“ registrieren.

Die Registrierung einer Erweiterungsfabrik erfolgt in der Regel 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 dafür vorgesehen, direkt instanziiert zu werden. Sie können über die Funktion ` QDesignerFormEditorInterface::extensionManager()` eine Schnittstelle zum Erweiterungsmanager des „ Qt Widgets “-Designers abrufen. Ein Zeiger auf das aktuelle ` QDesignerFormEditorInterface `-Objekt des „ Qt Widgets “-Designers (im obigen Beispiel `formEditor `) wird über den Parameter der Funktion ` QDesignerCustomWidgetInterface::initialize()` bereitgestellt. Bei der Implementierung eines benutzerdefinierten Widget-Plugins müssen Sie eine Unterklasse von ` QDesignerCustomWidgetInterface ` erstellen, um Ihr Plugin dem „ Qt Widgets “-Designer zur Verfügung zu stellen.

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

Im „ Qt Widgets Designer“ stehen vier Arten von Erweiterungen zur Verfügung: „ QDesignerContainerExtension “, „ QDesignerMemberSheetExtension “, „ QDesignerPropertySheetExtension “ und „ QDesignerTaskMenuExtension “. Das Verhalten des „ Qt Widgets Designers“ ist unabhängig davon, ob die angeforderte Erweiterung mit einem Container, einem Member-Sheet, einem Property-Sheet oder einem Aufgabenmenü verknüpft ist.

Ein vollständiges Beispiel für die Verwendung der Klasse `QExtensionManager` finden Sie im Beispiel „Task Menu Extension“. Das Beispiel zeigt, wie Sie ein benutzerdefiniertes Widget-Plugin für „ Qt Designer “ erstellen und wie Sie mithilfe der Klasse ` QDesignerTaskMenuExtension ` benutzerdefinierte Elemente zum Aufgabenmenü des „ Qt Widgets Designer“ hinzufügen.