Una guía rápida para Qt Widgets Designer
Qt Widgets Designer consta de cuatro pasos básicos:
- Elige tu formulario y tus objetos
- Coloca los objetos en el formulario
- Conecta las señales a las ranuras
- Previsualiza el formulario

Supongamos que quieres diseñar un pequeño widget (véase la captura de pantalla anterior) que contenga los controles necesarios para manipular los valores de rojo, verde y azul (RGB), un tipo de widget que se puede ver en todas partes en los programas de edición de imágenes.
![]() | Seleccionar un formulario Empieza seleccionando «Widget » en el cuadro de diálogo «Nuevo formulario ». |
![]() | Colocar widgets en un formulario Arrastra tres etiquetas, tres cuadros de selección y tres controles deslizantes verticales al formulario. Para cambiar el texto predeterminado de una etiqueta, basta con hacer doble clic en ella. Puedes organizarlos según la disposición que desees. |
Para asegurarte de que queden dispuestos exactamente así en tu programa, debes colocar estos widgets en un diseño. Lo haremos en grupos de tres. Selecciona la etiqueta «RED». A continuación, mantén pulsada la tecla Ctrl mientras seleccionas el cuadro giratorio y el control deslizante correspondientes. En el menú «Formulario», selecciona «Disposición en cuadrícula».
![]() | ![]() |
Repite el paso con las otras dos etiquetas, junto con sus respectivos cuadros giratorios y controles deslizantes.
El siguiente paso consiste en combinar las tres distribuciones en una distribución principal. La distribución principal es la del widget de nivel superior (en este caso, el « QWidget »). Es importante que tu widget de nivel superior tenga una distribución; de lo contrario, los widgets de tu ventana no cambiarán de tamaño cuando se modifique el tamaño de la ventana. Para establecer el diseño, haz clic con el botón derecho en cualquier lugar del formulario, fuera de los tres diseños independientes, y selecciona «Diseño horizontal». Como alternativa, también puedes seleccionar «Diseño en cuadrícula »; seguirás viendo la misma disposición (como se muestra a continuación).

Nota: Los diseñosprincipales no se ven en el formulario. Para comprobar si tienes un diseño principal configurado, prueba a cambiar el tamaño de tu formulario; tus widgets deberían adaptarse en consecuencia. También puedes echar un vistazo al «Inspector de objetos» de Qt Widgets Designer. Si tu widget de nivel superior no tiene un diseño, verás el icono de diseño roto junto a él,
.
Al hacer clic en el control deslizante y arrastrarlo hasta un valor determinado, lo que quieres es que el cuadro giratorio muestre la posición del control deslizante. Para conseguir este comportamiento, debes conectar la señal valueChanged() del control deslizante a la ranura setValue() del cuadro giratorio. También debes establecer las conexiones inversas; por ejemplo, conectar la señal « valueChanged()» del cuadro de selección a la ranura « setValue()» del control deslizante.
Para ello, debes pasar al modo «Editar señales/ranuras », ya sea pulsando F4 o seleccionando «Editar señales/ranuras » en el menú «Editar ».
![]() | Conexión de señales a ranuras Haz clic en el control deslizante y arrastra el cursor hacia el cuadro de selección. Aparecerá el cuadro de diálogo «Configurar conexión », que se muestra a continuación. Selecciona la señal y la ranura correctas y haz clic en «Aceptar». |

Repite el paso (en orden inverso), haciendo clic en el cuadro de selección y arrastrando el cursor hacia el control deslizante, para conectar la señal « valueChanged » () del cuadro de selección a la ranura « setValue » () del control deslizante.
Puedes utilizar la captura de pantalla que aparece a continuación como guía para seleccionar la señal y la ranura correctas.

Ahora que has conectado correctamente los objetos para el componente «ROJO» del controlador RGB, haz lo mismo con los componentes «VERDE» y «AZUL».
Dado que los valores RGB oscilan entre 0 y 255, debemos limitar el cuadro de selección y el control deslizante a ese rango concreto.
![]() | Configuración de las propiedades del widget Haz clic en el primer cuadro giratorio. En el Editor de propiedades, verás las propiedades de « QSpinBox ». Introduce «255» en la propiedad « maximum ». A continuación, haz clic en el primer control deslizante vertical; verás las propiedades de « QAbstractSlider ». Introduce «255» también en la propiedad « maximum ». Repite este proceso para el resto de cuadros giratorios y controles deslizantes. |
Ahora, previsualiza el formulario para ver cómo quedaría en tu aplicación: pulsa Ctrl + R o selecciona «Previsualizar » en el menú «Formulario ». Prueba a arrastrar el control deslizante: el cuadro de selección reflejará también su valor (y viceversa). Además, puedes cambiar su tamaño para ver cómo los diseños que se utilizan para gestionar los widgets secundarios responden a diferentes tamaños de ventana.
© 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.





