En esta página

Uso de widgets personalizados con Qt Widgets Designer

Qt Widgets Designer puede mostrar widgets personalizados a través de su mecanismo de plugins extensible, lo que permite ampliar la gama de widgets personalizables tanto por el usuario como por terceros. Como alternativa, es posible utilizar widgets existentes como marcadores de posición para clases de widgets que proporcionen API similares.

Manejo de widgets personalizados

Aunque Qt Widgets Designer es compatible con todos los Qt Widgets estándar, es posible que algunos widgets especializados no estén disponibles de forma predeterminada por diversas razones:

  • Es posible que los widgets personalizados no estén disponibles en el momento en que se diseña la interfaz de usuario.
  • Los widgets personalizados pueden ser específicos de una plataforma, y es posible que los diseñadores estén desarrollando la interfaz de usuario en una plataforma diferente a la de los usuarios finales.
  • El código fuente de un widget personalizado no está disponible, o los diseñadores de la interfaz de usuario no pueden utilizar el widget por razones no técnicas.

En las situaciones anteriores, sigue siendo posible diseñar formularios con el objetivo de utilizar widgets personalizados en la aplicación. Para ello, podemos utilizar la función de promoción de widgets de Qt Widgets Designer.

En todos los demás casos, cuando se dispone del código fuente de los widgets personalizados, podemos adaptar el widget personalizado para su uso con Qt Widgets Designer.

Promoción de widgets

Captura de pantalla de la ventana «Widgets promocionados», en la que se muestran las opciones para añadir una clase de widget personalizada especificando una clase base, el nombre de la clase promocionada y el archivo de cabecera

Si hay que diseñar algunos formularios, pero el diseñador no dispone de determinados widgets personalizados, podemos sustituirlos por widgets similares que representen a los que faltan. Por ejemplo, podríamos representar instancias de una clase de botón personalizada, MyPushButton, con instancias de QPushButton y promocionarlas a MyPushButton para que uic genere el código adecuado para esta clase que falta.

A la hora de elegir un widget para utilizarlo como marcador de posición, resulta útil comparar la API del widget que falta con las de los widgets estándar de Qt. En el caso de los widgets especializados que son subclases de clases estándar, la elección obvia como marcador de posición es la clase base del widget personalizado; por ejemplo, QSlider podría utilizarse para subclases especializadas de QSlider.

En el caso de los widgets especializados que no comparten una API común con los widgets estándar de Qt Widgets, merece la pena considerar la posibilidad de adaptar un widget personalizado para su uso en ` Qt Widgets Designer`. Si esto no es posible, ` QWidget ` es la opción más obvia como widget marcador de posición, ya que es el mínimo común denominador para todos los widgets.

Para añadir un marcador de posición, selecciona un objeto de una clase base adecuada y elige «Promover a...» en el menú contextual del formulario. Tras introducir el nombre de la clase y el archivo de cabecera en la parte inferior del cuadro de diálogo, selecciona «Añadir». La clase del marcador de posición aparecerá ahora junto con la clase base en la lista superior. Haz clic en el botón «Promover» para aceptar esta elección.

Ahora, al abrir el menú contextual del formulario sobre objetos de la clase base, la clase de marcador de posición aparecerá en el submenú «Promover a», lo que permite promover cómodamente los objetos a esa clase.

Un widget promovido puede volver a su clase base seleccionando «Rebajar a » en el menú contextual del formulario.

Widgets personalizados definidos por el usuario

Los widgets personalizados pueden adaptarse para su uso con Qt Widgets Designer, lo que ofrece a los diseñadores la oportunidad de configurar la interfaz de usuario utilizando los widgets reales que se emplearán en una aplicación, en lugar de widgets de marcador de posición. El proceso de creación de un complemento de widget personalizado se describe en el capítulo «Creación de widgets personalizados para Qt Widgets Designer » de este manual.

Para utilizar un complemento creado de esta forma, es necesario asegurarse de que el complemento se encuentre en una ruta en la que Qt Widgets Designer busque los complementos. Por lo general, los complementos almacenados en $QTDIR/plugins/designer se cargarán al iniciar Qt Widgets Designer. Puede encontrar más información sobre cómo compilar e instalar complementos aquí. También puede consultar el documento «Plugins HOWTO» para obtener información sobre la creación de complementos.

© 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.