Una guía rápida para Qt Widgets Designer

Qt Widgets Designer consta de cuatro pasos básicos:

  1. Elige tu formulario y tus objetos
  2. Coloca los objetos en el formulario
  3. Conecta las señales a las ranuras
  4. Previsualiza el formulario

Captura de pantalla en la que se muestra un controlador RGB con controles deslizantes para ajustar los valores de rojo, verde y azul

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.

Captura de pantalla en la que se muestra un formulario en forma de lista con todos los componentes que hay que añadir a la ventanaSeleccionar un formulario

Empieza seleccionando «Widget » en el cuadro de diálogo «Nuevo formulario ».

Captura de pantalla en la que se muestra la disposición de los componentes del controlador RGBColocar 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».

Captura de pantalla en la que se muestra la disposición de los componentes del controlador RGB, con uno de ellos seleccionadoCaptura de pantalla en la que se muestra la opción «Distribuir en cuadrícula» en el editor Qt Widgets Designer

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

Captura de pantalla que muestra el resultado del diseño final

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, Captura de pantalla en la que se muestra la opción para no utilizar un diseño de nivel superior.

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

Captura de pantalla del controlador RGB en la que se muestra la conexión de la señal entre el control deslizante y el cuadro de selecciónConexió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».

Captura de pantalla en la que se muestra la configuración para conectar el cuadro giratorio con el control deslizante, de modo que el valor del cuadro giratorio modifique el valor del control deslizante

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.

Captura de pantalla en la que se muestra la configuración para conectar el control deslizante con el cuadro de selección, de modo que el control deslizante modifique el valor del cuadro de selección

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.

Captura de pantalla en la que se muestra la opción para modificar los valores mínimo y máximo que se pueden introducir en el cuadro de selecciónConfiguració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.