Класс QExtensionManager

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

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

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

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

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

Статические открытые члены

• 9 статических открытых членов, унаследованных от QObject

Макросы

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

• 1 свойство, унаследованное от QObject
• 1 открытый слот, унаследованный от QObject
• 2 сигналы, унаследованные от 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.

[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")