Класс QExtensionManager

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

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

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

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

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

Макросы

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

• 1 свойство, унаследованное от QObject
• 1 открытый слот, унаследованный от QObject
• 2 сигнала, унаследованные от QObject
• 1 открытая переменная, унаследованная от QObject
• 10 статических открытых членов, унаследованных от QObject
• 9 защищенных функций, унаследованных от QObject
• 2 защищенных переменных, унаследованных от 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.

[virtual] QExtensionManager::~QExtensionManager()

Удаляет менеджер расширений

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

Переопределяет функцию QAbstractExtensionManager::extension().

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

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

Переопределяет функцию QAbstractExtensionManager::registerExtensions().

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

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

Переопределяет функцию QAbstractExtensionManager::unregisterExtensions().

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

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