Класс QExtensionManager

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

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

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

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

• 32 открытых функций, унаследованных от 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")