Класс QExtensionManager

Класс QExtensionManager предоставляет средства управления расширениями для Qt Designer. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Переопределённые открытые функции

• 31 открытых функций, унаследованных от QObject
• 3 открытых функции, унаследованных от QAbstractExtensionManager

Связанные нечлены

Макросы

Дополнительные унаследованные члены

• 1 свойство, унаследованное от QObject
• 1 открытый слот, унаследованный от QObject
• 2 сигнала, унаследованные от QObject
• 11 статических открытых членов, унаследованных от QObject
• 9 защищенных функций, унаследованных от QObject

Подробное описание

Класс QExtensionManager предоставляет средства управления расширениями для Qt Designer.

В Qt Designer расширения не создаются до тех пор, пока они не понадобятся. По этой причине при реализации расширения необходимо также создать QExtensionFactory, т.е. класс, способный создать экземпляр вашего расширения, и зарегистрировать его с помощью менеджера расширений Qt Designer.

Регистрация фабрики расширения обычно выполняется в функции QDesignerCustomWidgetInterface::initialize():

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

            QExtensionManager *manager = formEditor->extensionManager();
            Q_ASSERT(manager != 0);

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

            initialized = true;
        }

Класс QExtensionManager не предназначен для прямого создания экземпляров. Вы можете получить интерфейс к менеджеру расширений Qt Designer, используя функцию QDesignerFormEditorInterface::extensionManager(). Указатель на текущий объект QDesignerFormEditorInterface Qt Designer (formEditor в примере выше) предоставляется в качестве параметра функции QDesignerCustomWidgetInterface::initialize(). При реализации плагина пользовательского виджета необходимо унаследовать класс QDesignerCustomWidgetInterface, чтобы предоставить ваш плагин для Qt Designer.

Затем, когда требуется расширение, менеджер расширений Qt Designer перебирает все зарегистрированные фабрики, вызывая QExtensionFactory::createExtension() для каждой, пока не найдёт первую, способную создать запрашиваемое расширение для выбранного объекта. Эта фабрика затем создаст экземпляр расширения.

Существует четыре доступных типа расширений в Qt Designer: QDesignerContainerExtension, QDesignerMemberSheetExtension, QDesignerPropertySheetExtension и QDesignerTaskMenuExtension. Поведение Qt Designer одинаково независимо от того, связано ли запрашиваемое расширение с контейнером, листом членов, листом свойств или меню задач.

Полный пример использования класса QExtensionManager см. в примере расширения меню задач. Пример показывает, как создать плагин пользовательского виджета для Qt Designer и как использовать класс QDesignerTaskMenuExtension, чтобы добавить пользовательские пункты в меню задач Qt Designer.

См. также QExtensionFactory и QAbstractExtensionManager.

Документация по функциям-членам

QExtensionManager::QExtensionManager(QObject *parent = Q_NULLPTR)

Создаёт менеджер расширений с указанным parent.

QExtensionManager::~QExtensionManager()

Уничтожает менеджер расширений

[virtual] QObject *QExtensionManager::extension(QObject *object, const QString &iid) const

Переопределяет QAbstractExtensionManager::extension().

Возвращает расширение, заданное iid, для данного object.

[virtual] void QExtensionManager::registerExtensions(QAbstractExtensionFactory *factory, const QString &iid = QString())

Переопределяет QAbstractExtensionManager::registerExtensions().

Регистрирует расширение, заданное данным factory и идентификатором расширения iid.

[virtual] void QExtensionManager::unregisterExtensions(QAbstractExtensionFactory *factory, const QString &iid = QString())

Переопределяет QAbstractExtensionManager::unregisterExtensions().

Дезактивирует расширение, заданное данным factory и идентификатором расширения iid.

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

       propertySheet = qt_extension<QDesignerPropertySheetExtension*>(manager, widget);

       if(propertySheet) {...}

   Q_DECLARE_EXTENSION_INTERFACE(MyExtension, "com.mycompany.myproduct.myextension")