Creación y uso de componentes para Qt Widgets Designer
Creación de complementos de widgets personalizados
Al implementar un complemento de widget personalizado para Qt Widgets Designer, debes crear una subclase de QDesignerCustomWidgetInterface para que tu widget personalizado sea visible en Qt Widgets Designer. Cada complemento de widget personalizado se compila como una biblioteca independiente. Si deseas incluir varios complementos de widget personalizados en la misma biblioteca, debes crear además una subclase de QDesignerCustomWidgetCollectionInterface.
Para dotar a tu complemento de widget personalizado del comportamiento y la funcionalidad esperados dentro del espacio de trabajo de Qt Widgets Designer, puedes crear una subclase de las clases de extensión asociadas:
La clase QDesignerContainerExtension te permite añadir páginas a un contenedor multipágina personalizado. La clase QDesignerTaskMenuExtension te permite añadir entradas de menú personalizadas al menú de tareas de Qt Widgets Designer. La clase QDesignerMemberSheetExtension te permite manipular las funciones miembro de un widget que se muestra al configurar conexiones utilizando el modo de Qt Widgets Designer para editar señales y ranuras. Y, por último, la clase QDesignerPropertySheetExtension te permite manipular las propiedades de un widget que se muestran en el editor de propiedades de Qt Widgets Designer.
Qt Widgets Designer" src="images/qtdesignerextensions.png" title="Diagrama que muestra la relación entre los componentes de Qt Widgets Designer"/>
En Qt Widgets Designer, las extensiones no se crean hasta que son necesarias. Por ese motivo, al implementar extensiones, también debes crear una subclase de ` QExtensionFactory`, es decir, crear una clase capaz de crear instancias de tus extensiones. Además, debes hacer que el gestor de extensiones de Qt Widgets Designer registre tu fábrica; el gestor de extensiones controla la creación de extensiones a medida que se necesitan, y puedes acceder a él a través de QDesignerFormEditorInterface y QExtensionManager.
Para ver un ejemplo completo sobre cómo crear un complemento de widget personalizado con una extensión, consulta los ejemplos «Extensión del menú de tareas » o «Extensión de contenedor ».
Obtención de acceso a los componentes de Qt Widgets Designer
El objetivo de las clases mencionadas en esta sección es proporcionar acceso a los componentes, gestores y espacio de trabajo de Qt Widgets Designer, y no están pensadas para ser instanciadas directamente.
Qt Widgets Designer xml-ph-0000@deepl.internal se compone de varios componentes. Cuenta con un editor de acciones, un editor de propiedades, un cuadro de widgets y un inspector de objetos que se pueden ver en su espacio de trabajo.
Qt Widgets Designer" src="images/qtdesignerscreenshot.png" title="Captura de pantalla en la que se muestra la interfaz de usuario del editor Qt Widgets Designer"/>
Qt Widgets Designer Qt Widgets Designer también cuenta con un objeto que funciona en segundo plano; contiene la lógica que integra todos los componentes de en una aplicación coherente. Se puede acceder a este objeto, utilizando el método ` `, para recuperar las interfaces de los componentes de : QDesignerFormEditorInterface Qt Widgets Designer
- QDesignerActionEditorInterface
- QDesignerObjectInspectorInterface
- QDesignerPropertyEditorInterface
- QDesignerWidgetBoxInterface
Además, puede utilizar QDesignerFormEditorInterface para recuperar interfaces del gestor de extensiones de Qt Widgets Designer(QExtensionManager) y del gestor de ventanas de formularios (QDesignerFormWindowManagerInterface). El gestor de extensiones controla la creación de extensiones según sean necesarias, mientras que el gestor de ventanas de formularios controla las ventanas de formulario que aparecen en el espacio de trabajo de Qt Widgets Designer.
Una vez que dispones de una interfaz para el gestor de ventanas de formulario de Qt Widgets Designer(QDesignerFormWindowManagerInterface), también tienes acceso a todas las ventanas de formulario que aparecen actualmente en el espacio de trabajo de Qt Widgets Designer: La clase ` QDesignerFormWindowInterface ` te permite consultar y manipular las ventanas de formulario, y proporciona una interfaz para los cursores de dichas ventanas. ` QDesignerFormWindowCursorInterface ` es una clase de conveniencia que te permite consultar y modificar la selección de widgets de una ventana de formulario determinada y, además, modificar las propiedades de todos los widgets del formulario.
Creación de interfaces de usuario en tiempo de ejecución
El módulo « QtDesigner » contiene la clase « QFormBuilder », que proporciona un mecanismo para crear dinámicamente interfaces de usuario en tiempo de ejecución, basándose en archivos de interfaz de usuario creados con « Qt Widgets Designer ». Esta clase suele ser utilizada por componentes personalizados y aplicaciones que incorporan « Qt Widgets Designer ». Las aplicaciones independientes que necesitan generar dinámicamente interfaces de usuario en tiempo de ejecución utilizan la clase « QUiLoader », que se encuentra en el módulo « QtUiTools ».
Para ver un ejemplo completo que utiliza QUiLoader, consulta el ejemplo «Calculator Builder».
Véase también el Manual deQt Widgets Designer y Qt UI Tools.
© 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.