Creación de extensiones de widgets personalizados
Una vez que dispongas de un complemento de widget personalizado para Qt Widgets Designer, podrás dotarlo del comportamiento y la funcionalidad esperados dentro del espacio de trabajo de Qt Widgets Designer, utilizando extensiones de widgets personalizadas.
Tipos de extensiones
Hay varios tipos de extensiones disponibles en Qt Widgets Designer. Puedes utilizar todas estas extensiones siguiendo el mismo patrón, simplemente sustituyendo la clase base de la extensión correspondiente.
QDesignerContainerExtension es necesario a la hora de implementar un contenedor multipágina personalizado.
![]() | QDesignerTaskMenuExtension QDesignerTaskMenuExtension Es útil para widgets personalizados. Proporciona una extensión que permite añadir entradas de menú personalizadas al menú de tareas de Qt Widgets Designer. El ejemplo «Extensión del menú de tareas» ilustra cómo utilizar esta clase. |
![]() | QDesignerContainerExtension QDesignerContainerExtension Es necesario a la hora de implementar un contenedor multipágina personalizado. Proporciona una extensión que permite añadir y eliminar páginas para un complemento de contenedor multipágina en Qt Widgets Designer. El ejemplo «Extensión de contenedor» explica con más detalle cómo utilizar esta clase. Nota: Noes posible añadir propiedades personalizadas por página para algunos widgets (por ejemplo, QTabWidget) debido a la forma en que están implementados. |
![]() | QDesignerMemberSheetExtension La clase ` QDesignerMemberSheetExtension ` permite manipular las funciones miembro de un widget que se muestran al conectar señales y ranuras. |
![]() | QDesignerPropertySheetExtension, QDesignerDynamicPropertySheetExtension Estas clases de extensión te permiten controlar cómo se muestran las propiedades de un widget en el editor de propiedades de Qt Widgets Designer. |
Qt Widgets Designer utiliza las clases ` QDesignerPropertySheetExtension ` y ` QDesignerMemberSheetExtension ` para alimentar sus editores de propiedades, señales y ranuras. Cada vez que se selecciona un widget en su espacio de trabajo, ` Qt Widgets Designer ` consultará la extensión de la hoja de propiedades del widget; del mismo modo, cada vez que se solicita una conexión entre dos widgets, ` Qt Widgets Designer ` consultará las extensiones de las hojas de miembros de los widgets.
Advertencia: Todos los widgets tienen hojas de propiedades y de miembros predeterminadas. Si implementas extensiones personalizadas para las hojas de propiedades o de miembros, tus extensiones personalizadas anularán las hojas predeterminadas.
Creación de una extensión
Para crear una extensión, debes heredar tanto de ` QObject ` como de la clase base adecuada, y reimplementar sus funciones. Dado que estamos implementando una interfaz, debemos asegurarnos de que el sistema de metaobjetos la reconozca utilizando la macro ` Q_INTERFACES()` en la definición de la clase de extensión. Por ejemplo:
class MyExtension: public QObject,
public QDesignerContainerExtension
{
Q_OBJECT
Q_INTERFACE(QDesignerContainerExtension)
...
}Esto permite que ` Qt Widgets Designer ` utilice la función ` qobject_cast()` para consultar las interfaces compatibles utilizando únicamente un puntero ` QObject `.
Exposición de una extensión a Qt Widgets Designer
En Qt Widgets Designer, las extensiones no se crean hasta que son necesarias. Por este motivo, al implementar extensiones, debes crear una subclase de QExtensionFactory para crear una clase capaz de generar instancias de tus extensiones. Además, debes registrar tu fábrica en el gestor de extensiones de Qt Widgets Designer; el gestor de extensiones se encarga de la construcción de las extensiones.
Cuando se solicita una extensión, el gestor de extensiones de Qt Widgets Designer recorrerá sus fábricas registradas llamando a QExtensionFactory::createExtension() para cada una de ellas hasta que encuentre una capaz de crear la extensión solicitada para el widget seleccionado. A continuación, esta fábrica creará una instancia de la extensión.

Creación de una fábrica de extensiones
La clase QExtensionFactory proporciona una fábrica de extensiones estándar, pero también puede utilizarse como interfaz para fábricas de extensiones personalizadas.
El objetivo es reimplementar la función QExtensionFactory::createExtension(), de modo que pueda crear tu extensión, como por ejemplo una extensión de contenedor MultiPageWidget.
Puedes crear una nueva clase ` QExtensionFactory ` y reimplementar la función ` QExtensionFactory::createExtension()`:
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 utilizar una fábrica existente, ampliando la función ` QExtensionFactory::createExtension()` para que la fábrica también pueda crear su extensión personalizada:
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;
}
}Acceso al gestor de extensiones de Qt Widgets Designer
Al implementar un complemento de widget personalizado, debes crear una subclase de ` QDesignerCustomWidgetInterface ` para exponer tu complemento a ` Qt Widgets Designer`. Esto se explica con más detalle en la sección «Creación de widgets personalizados para Qt Widgets Designer ». El registro de una fábrica de extensiones se suele realizar en la función ` 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;
}El parámetro formEditor de la función QDesignerCustomWidgetInterface::initialize() es un puntero al objeto QDesignerFormEditorInterface actual de Qt Widgets Designer. Debes utilizar la función QDesignerFormEditorInterface::extensionManager() para obtener una interfaz al gestor de extensiones de Qt Widgets Designer. A continuación, utiliza la función QExtensionManager::registerExtensions() para registrar tu fábrica de extensiones personalizada.
Ejemplos relacionados
Para obtener más información sobre la creación de extensiones de widgets personalizadas en Qt Widgets Designer, consulta los ejemplos «Extensión del menú de tareas » y «Extensión de contenedor ».
© 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.



