QDesignerContainerExtension Class
La clase QDesignerContainerExtension te permite añadir páginas a un contenedor multipágina personalizado en el espacio de trabajo de Qt Widgets Designer. Más información...
| Encabezado: | #include <QDesignerContainerExtension> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Designer) target_link_libraries(mytarget PRIVATE Qt6::Designer) |
| qmake: | QT += designer |
Funciones públicas
| QDesignerContainerExtension() | |
| QDesignerContainerExtension(const QDesignerContainerExtension &) | |
| QDesignerContainerExtension(QDesignerContainerExtension &&) | |
| virtual | ~QDesignerContainerExtension() |
| virtual void | addWidget(QWidget *page) = 0 |
| virtual bool | canAddWidget() const = 0 |
| virtual bool | canRemove(int index) const = 0 |
| virtual int | count() const = 0 |
| virtual int | currentIndex() const = 0 |
| virtual void | insertWidget(int index, QWidget *page) = 0 |
| virtual void | remove(int index) = 0 |
| virtual void | setCurrentIndex(int index) = 0 |
| virtual QWidget * | widget(int index) const = 0 |
| QDesignerContainerExtension & | operator=(QDesignerContainerExtension &&) |
| QDesignerContainerExtension & | operator=(const QDesignerContainerExtension &) |
Descripción detallada
Qt Widgets Designer en la que se muestra la opción de insertar una página antes de la página actual en un objeto" src="images/containerextension-example.webp" title="Captura de pantalla del editor de interfaz de usuario Qt Widgets Designer en la que se muestra la opción de insertar una página antes de la página actual en un objeto"/>
QDesignerContainerExtension proporciona una interfaz para crear extensiones de contenedores personalizadas. Una extensión de contenedor consta de un conjunto de funciones que Qt Widgets Designer necesita para gestionar un complemento de contenedor de varias páginas, y una lista de las páginas del contenedor.
Advertencia: Nose trata de una extensión para complementos de contenedores en general, sino únicamente para contenedores personalizados de varias páginas.
Para crear una extensión de contenedor, tu 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 el sistema de metaobjetos la reconozca mediante la macro Q_INTERFACES(). Esto permite que Qt Widgets Designer utilice la función qobject_cast() para consultar las interfaces compatibles utilizando únicamente un puntero QObject.
Debes reimplementar varias funciones para que Qt Widgets Designer pueda gestionar un widget contenedor multipágina personalizado: Qt Widgets Designer utiliza count() para llevar la cuenta del número de páginas de tu contenedor, widget() para devolver la página situada en un índice determinado de la lista de páginas del contenedor, y currentIndex() para devolver el índice de la lista correspondiente a 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 al final de 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 se solicitan. Por ese motivo, también debes crear un QExtensionFactory, es decir, una clase capaz de crear una instancia de tu extensión, y registrarla mediante extension manager de Qt Widgets Designer.
Cuando se requiere una extensión de contenedor, la función ` extension manager ` de Qt Widgets Designer recorrerá todas sus fábricas registradas llamando a ` QExtensionFactory::createExtension()` para cada una de ellas hasta que encuentre la primera capaz de crear una extensión de contenedor. A continuación, esta fábrica creará la extensión para el complemento.
Hay cuatro tipos de extensiones disponibles en Qt Widgets Designer: QDesignerContainerExtension, QDesignerMemberSheetExtension, QDesignerPropertySheetExtension y QDesignerTaskMenuExtension. El comportamiento de Qt Widgets Designer es el mismo independientemente de 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. Puedes crear una nueva clase ` 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 bien, puede utilizar una fábrica existente, ampliando la función ` QExtensionFactory::createExtension()` para que la fábrica también pueda crear una extensión de contenedor. 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 ver un ejemplo completo que utiliza la clase `QDesignerContainerExtension`, consulta el ejemplo «Extensión de contenedor». El ejemplo muestra cómo crear un complemento personalizado de varias páginas para ` Qt Widgets Designer`.
Véase también « QExtensionFactory» , « QExtensionManager » y «Creación de extensiones de widgets personalizadas».
Documentación de las funciones de miembro
[constexpr noexcept default] QDesignerContainerExtension::QDesignerContainerExtension()
Crea por defecto una instancia de ` QDesignerContainerExtension`.
[delete] QDesignerContainerExtension::QDesignerContainerExtension(const QDesignerContainerExtension &)
Crea una instancia de ` QDesignerContainerExtension` mediante copia. Esta función se ha eliminado.
[delete] QDesignerContainerExtension::QDesignerContainerExtension(QDesignerContainerExtension &&)
Crea una instancia de ` QDesignerContainerExtension`. Esta función se ha eliminado.
[virtual constexpr noexcept default] QDesignerContainerExtension::~QDesignerContainerExtension()
Elimina la extensión.
[pure virtual] void QDesignerContainerExtension::addWidget(QWidget *page)
Añade el page indicado al contenedor, incorporándolo a la lista de páginas de la extensión.
Véase también insertWidget(), remove() y widget().
[pure virtual] bool QDesignerContainerExtension::canAddWidget() const
Devuelve si se puede añadir un widget. Esto determina si están activadas las opciones del menú contextual para añadir o insertar páginas.
Debería devolver «false» para los contenedores que tengan una única página fija, por ejemplo, QScrollArea o QDockWidget.
Véase también addWidget() y canRemove().
[pure virtual] bool QDesignerContainerExtension::canRemove(int index) const
Devuelve si se puede eliminar el widget de la dirección index indicada. Esto determina si está activada la opción del menú contextual para eliminar la página actual.
Debería devolver «false» para los contenedores que tengan una única página fija, por ejemplo, QScrollArea o QDockWidget.
Véase también remove() y canAddWidget().
[pure virtual] int QDesignerContainerExtension::count() const
Devuelve el número de páginas que contiene el contenedor.
[pure virtual] int QDesignerContainerExtension::currentIndex() const
Devuelve el índice de la página seleccionada actualmente en el contenedor.
Véase también setCurrentIndex().
[pure virtual] void QDesignerContainerExtension::insertWidget(int index, QWidget *page)
Añade la dirección page al contenedor insertándola en la posición index de la lista de páginas de la extensión.
Véase también addWidget(), remove() y widget().
[pure virtual] void QDesignerContainerExtension::remove(int index)
Elimina la página de la dirección index de la lista de páginas de la extensión.
Véase también addWidget() y insertWidget().
[pure virtual] void QDesignerContainerExtension::setCurrentIndex(int index)
Establece la página seleccionada actualmente en el contenedor como la página que se encuentra en la dirección index, dentro de la lista de páginas de la extensión.
Véase también currentIndex().
[pure virtual] QWidget *QDesignerContainerExtension::widget(int index) const
Devuelve la página correspondiente a la URL index en la lista de páginas de la extensión.
Véase también addWidget() y insertWidget().
[delete] QDesignerContainerExtension &QDesignerContainerExtension::operator=(QDesignerContainerExtension &&)
Asigna mediante «move» other a esta instancia de QDesignerContainerExtension. Esta función se elimina.
[delete] QDesignerContainerExtension &QDesignerContainerExtension::operator=(const QDesignerContainerExtension &)
Asigna por copia « other » a esta instancia de « QDesignerContainerExtension ». Esta función se ha eliminado.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.