QDesignerMemberSheetExtension Class

Descripción detallada

QDesignerMemberSheetExtension es una colección de funciones que se utilizan normalmente para consultar las funciones miembro de un widget, y para manipular la apariencia de las funciones miembro en el modo de edición de señales y ranuras de Qt Widgets Designer. Por ejemplo:

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

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

delete memberSheet;

Al implementar un complemento de widget personalizado, el parámetro de la función QDesignerCustomWidgetInterface::initialize() proporciona un puntero al objeto QDesignerFormEditorInterface actual de Qt Widgets Designer (formEditor en el ejemplo anterior).

La hoja de miembro (y cualquier otra extensión), puede ser recuperada consultando el gestor de extensiones de Qt Widgets Designer utilizando la función qt_extension(). Cuando quieras liberar la extensión, sólo tienes que borrar el puntero.

Todos los widgets tienen una hoja de miembros por defecto que se utiliza en Qt Widgets Modo de edición de señales y ranuras de Designer con las funciones miembro del widget. Pero QDesignerMemberSheetExtension también proporciona una interfaz para crear extensiones de hoja de miembros personalizadas.

Para crear una extensión de hoja de miembro, tu clase de extensión debe heredar tanto de QObject como de QDesignerMemberSheetExtension. A continuación, puesto que estamos implementando una interfaz, debemos asegurarnos de que se da a conocer al sistema de metaobjetos mediante la macro Q_INTERFACES():

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

public:
    ...
}

Esto permite a Qt Widgets Designer utilizar qobject_cast() para consultar las interfaces soportadas utilizando únicamente un puntero QObject.

En Qt Widgets Designer las extensiones no se crean hasta que son necesarias. Por este motivo, al implementar una extensión de la hoja de miembros, también debes crear una QExtensionFactory, es decir, una clase que sea capaz de crear una instancia de tu extensión, y registrarla utilizando extension manager de Qt Widgets Designer.

Cuando se necesite una extensión de la hoja de miembros de un widget, Qt Widgets Designer's extension manager recorrerá todas las fábricas registradas llamando a QExtensionFactory::createExtension() para cada una de ellas hasta que encuentre la primera que pueda crear una extensión de la hoja de miembros para ese widget. Esta fábrica creará una instancia de la extensión. Si no se encuentra dicha fábrica, Qt Widgets Designer utilizará la hoja de miembros por defecto.

Existen cuatro tipos de extensiones disponibles en Qt Widgets Designer: QDesignerContainerExtension QDesignerMemberSheetExtension, QDesignerPropertySheetExtension y QDesignerTaskMenuExtension. Qt Widgets El comportamiento de Designer es el mismo tanto si la extensión solicitada está asociada a un contenedor multipágina, una hoja de miembros, una hoja de propiedades o un menú de tareas.

La clase QExtensionFactory proporciona una fábrica de extensiones estándar y también puede utilizarse como interfaz para fábricas de extensiones personalizadas. Puede crear un nuevo QExtensionFactory y reimplementar la función QExtensionFactory::createExtension(). por ejemplo:

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;
}

O puede utilizar una fábrica existente, ampliando la función QExtensionFactory::createExtension() para que la fábrica pueda crear también una extensión de hoja de miembro. Por ejemplo:

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;
    }
}

Para ver un ejemplo completo utilizando una clase de extensión, consulte Ejemplo de extensión del menú de tareas. El ejemplo muestra cómo crear un complemento de widget personalizado para Qt Designer, y cómo utilizar la clase QDesignerTaskMenuExtension para añadir elementos personalizados al menú de tareas de Qt Widgets Designer.