QDesignerMemberSheetExtension Class

Description détaillée

QDesignerMemberSheetExtension est une collection de fonctions typiquement utilisées pour interroger les fonctions membres d'un widget et pour manipuler l'apparence des fonctions membres dans le mode d'édition des signaux et des fentes de Qt Widgets Designer. Par exemple, lors de l'implémentation d'un plugin de widget personnalisé :

QDesignerMemberSheetExtension *memberSheet = nullptr;
QExtensionManager manager = formEditor->extensionManager();

memberSheet = qt_extension<QDesignerMemberSheetExtension*>(manager, widget);
int index = memberSheet->indexOf(setEchoMode);
memberSheet->setVisible(index, false);

delete memberSheet;

Lors de l'implémentation d'un plugin de widget personnalisé, un pointeur sur l'objet QDesignerFormEditorInterface actuel de Qt Widgets Designer(formEditor dans l'exemple ci-dessus) est fourni par le paramètre de la fonction QDesignerCustomWidgetInterface::initialize().

La feuille de membre (et toute autre extension) peut être récupérée en interrogeant le gestionnaire d'extensions de Qt Widgets Designer à l'aide de la fonction qt_extension(). Lorsque vous souhaitez libérer l'extension, il vous suffit de supprimer le pointeur.

Tous les widgets ont une feuille de membre par défaut utilisée dans le mode d'édition des signaux et des fentes de Qt Widgets Designer avec les fonctions membres du widget. Mais QDesignerMemberSheetExtension fournit également une interface pour créer des extensions de feuilles de membres personnalisées.

Pour créer une extension de feuille de membre, votre classe d'extension doit hériter à la fois de QObject et de QDesignerMemberSheetExtension. Ensuite, comme nous implémentons une interface, nous devons nous assurer qu'elle est connue du système de métaobjets à l'aide de la macro Q_INTERFACES() :

class MyMemberSheetExtension : public QObject,
        public QDesignerMemberSheetExtension
{
    Q_OBJECT
    Q_INTERFACES(QDesignerMemberSheetExtension)

public:
    ...
}

Cela permet à Qt Widgets Designer d'utiliser qobject_cast() pour rechercher les interfaces prises en charge en n'utilisant rien d'autre qu'un pointeur QObject.

Dans Qt Widgets Designer, les extensions ne sont pas créées tant qu'elles ne sont pas nécessaires. C'est pourquoi, lorsque vous implémentez une extension de feuille de membre, vous devez également créer une classe QExtensionFactory, c'est-à-dire une classe capable de créer une instance de votre extension et de l'enregistrer à l'aide de la classe extension manager de Qt Widgets Designer.

Lorsque l'extension de la feuille de membre d'un widget est requise, Qt Widgets Designer's extension manager passera en revue toutes ses usines enregistrées en appelant QExtensionFactory::createExtension() pour chacune d'entre elles jusqu'à ce que la première capable de créer une extension de la feuille de membre pour ce widget soit trouvée. Cette fabrique créera alors une instance de l'extension. Si aucune usine de ce type n'est trouvée, Qt Widgets Designer utilisera la feuille de membre par défaut.

Quatre types d'extensions sont disponibles dans Qt Widgets Designer: QDesignerContainerExtension, QDesignerMemberSheetExtension, QDesignerPropertySheetExtension et QDesignerTaskMenuExtension. Le comportement de Qt Widgets Designer est le même, que l'extension demandée soit associée à un conteneur multipage, à une feuille de membre, à une feuille de propriété ou à un menu de tâches.

La classe QExtensionFactory fournit une fabrique d'extensions standard et peut également être utilisée comme interface pour des fabriques d'extensions personnalisées. Vous pouvez soit créer un nouveau QExtensionFactory et réimplémenter la fonction QExtensionFactory::createExtension(). Par exemple :

QObject *ANewExtensionFactory::createExtension(QObject *object,
        const QString &iid, QObject *parent) const
{
    if (iid != Q_TYPEID(QDesignerMemberSheetExtension))
        return 0;

    if (MyCustomWidget *widget = qobject_cast<MyCustomWidget*>
           (object))
        return new MyMemberSheetExtension(widget, parent);

    return 0;
}

Ou vous pouvez utiliser une fabrique existante, en étendant la fonction QExtensionFactory::createExtension() pour que la fabrique puisse également créer une extension de feuille de membre. Voici un exemple :

QObject *AGeneralExtensionFactory::createExtension(QObject *object,
        const QString &iid, QObject *parent) const
{
    MyCustomWidget *widget = qobject_cast<MyCustomWidget*>(object);

    if (widget && (iid == Q_TYPEID(QDesignerTaskMenuExtension))) {
        return new MyTaskMenuExtension(widget, parent);

    } else if (widget && (iid == Q_TYPEID(QDesignerMemberSheetExtension))) {
        return new MyMemberSheetExtension(widget, parent);

    } else {
        return 0;
    }
}

Pour un exemple complet utilisant une classe d'extension, voir l'exemple d'extension de menu de tâches. L'exemple montre comment créer un plugin de widget personnalisé pour Qt Designer, et comment utiliser la classe QDesignerTaskMenuExtension pour ajouter des éléments personnalisés au menu des tâches de Qt Widgets Designer.