QDesignerContainerExtension Class

Descripción Detallada

Qt Widgets Designer mostrando la opción de insertar la página anterior a la actual en un objeto" src="images/containerextension-example.webp" title="Captura de pantalla del editor de IU Qt Widgets Designer mostrando la opción de insertar la página anterior a la actual en un objeto"/>

QDesignerContainerExtension proporciona una interfaz para crear extensiones de contenedor personalizadas. Una extensión de contenedor consiste en una colección de funciones que Qt Widgets Designer necesita para gestionar un plugin contenedor multipágina, y una lista de las páginas del contenedor.

Para crear una extensión de contenedor, su clase de extensión debe heredar tanto de QObject como de QDesignerContainerExtension. Por ejemplo:

class MyContainerExtension : public QObject,
       public QDesignerContainerExtension
{
    Q_OBJECT
    Q_INTERFACES(QDesignerContainerExtension)

public:
    MyContainerExtension(MyCustomWidget *widget,
                         QObject *parent = 0);
    int count() const;
    QWidget *widget(int index) const;
    int currentIndex() const;
    void setCurrentIndex(int index);
    void addWidget(QWidget *widget);
    void insertWidget(int index, QWidget *widget);
    void remove(int index);

private:
    MyCustomWidget *myWidget;
};

Dado que estamos implementando una interfaz, debemos asegurarnos de que se da a conocer al sistema de metaobjetos mediante la macro Q_INTERFACES(). Esto permite a Qt Widgets Designer utilizar la función qobject_cast() para buscar interfaces compatibles utilizando únicamente un puntero QObject.

Debes reimplementar varias funciones para permitir a Qt Widgets Designer gestionar un widget contenedor multipágina personalizado: Qt Widgets Designer utiliza count() para realizar un seguimiento del número de páginas del contenedor, widget() para devolver la página en un índice determinado de la lista de páginas del contenedor y currentIndex() para devolver el índice de la lista de la página seleccionada. Qt Widgets Designer utiliza la función addWidget() para añadir una página determinada al contenedor, esperando que se añada a la lista de páginas, mientras que espera que la función insertWidget() añada una página determinada al contenedor insertándola en un índice determinado.

En Qt Widgets Designer las extensiones no se crean hasta que son necesarias. Por esa razón debes crear también una QExtensionFactory, es decir, una clase que sea capaz de crear una instancia de tu extensión, y registrarla usando la extension manager de Qt Widgets Designer.

Cuando se necesite una extensión contenedora, Qt Widgets Designer's extension manager recorrerá todas las fábricas registradas llamando a QExtensionFactory::createExtension() en cada una de ellas hasta encontrar la primera que sea capaz de crear una extensión contenedora. Esta fábrica creará entonces la extensión para el plugin.

Hay 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(QDesignerContainerExtension))
        return 0;

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

    return 0;
}

O puede utilizar una fábrica existente, ampliando la función QExtensionFactory::createExtension() para que la fábrica sea capaz de crear también una extensión contenedora. 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(QDesignerContainerExtension))) {
        return new MyContainerExtension(widget, parent);

    } else {
        return 0;
    }
}

Para un ejemplo completo usando la clase QDesignerContainerExtension, ver el ejemplo de Extensión de Contenedor. El ejemplo muestra cómo crear un plugin multipágina personalizado para Qt Widgets Designer.