En esta página

Qt Widgets DesignerModo de edición de señales y ranuras

Captura de pantalla del modo de conexión de <span translate=Qt Widgets Designer, en la que se muestra la conexión de señales entre dos widgets" src="images/designer-connection-mode.png" title="Captura de pantalla del modo de conexión de Qt Widgets Designer, en la que se muestra la conexión de señales entre dos widgets"/>

En el modo de edición de señales y ranuras de Qt Widgets Designer, puedes conectar entre sí los objetos de un formulario utilizando el mecanismo de señales y ranuras de Qt. Tanto los widgets como los diseños se pueden conectar a través de una interfaz de conexión intuitiva, utilizando el menú de señales y ranuras compatibles que ofrece Qt Widgets Designer. Cuando se guarda un formulario, se conservan todas las conexiones, de modo que estarán listas para su uso cuando se compile el proyecto.

Para obtener más información sobre el mecanismo de señales y ranuras de Qt, consulta el documento «Señales y ranuras ».

Conexión de objetos

Para empezar a conectar objetos, acceda al modo de edición de señales y ranuras abriendo el menú Edición y seleccionando Editar señales/ranuras, o pulsando la tecla F4.

Todos los widgets y diseños del formulario se pueden conectar entre sí. Sin embargo, los espaciadores solo sirven para indicar el espaciado en los diseños, por lo que no se pueden conectar a otros objetos.

Captura de pantalla en la que se muestra un widget de un diseño resaltadoObjetos resaltados

Cuando el cursor se sitúe sobre un objeto que pueda utilizarse en una conexión, dicho objeto aparecerá resaltado.

Para establecer una conexión, pulsa el botón izquierdo del ratón y arrastra el cursor hacia el objeto al que quieras conectarlo. Al hacerlo, se extenderá una línea desde el objeto de origen hasta el cursor. Si el cursor se encuentra sobre otro objeto del formulario, la línea terminará con una flecha que apunta al objeto de destino. Esto indica que se establecerá una conexión entre los dos objetos al soltar el botón del ratón.

Puedes cancelar la conexión en cualquier momento mientras arrastras la ruta de conexión pulsando la tecla Esc.

Captura de pantalla que muestra cómo conectar un widget a otro haciendo clic con el botón izquierdo sobre el widget al que se desea conectarEstablecer una conexión

La ruta de conexión cambiará de forma a medida que el cursor se desplace por el formulario. A medida que pasa por encima de los objetos, estos se resaltan, lo que indica que pueden utilizarse en una conexión de señal y ranura. Suelta el botón del ratón para establecer la conexión.

Aparecerá el cuadro de diálogo «Configurar conexión» (a continuación), en el que se muestran las señales del objeto de origen y las ranuras del objeto de destino que puedes utilizar.

Captura de pantalla de la ventana en la que se muestran las señales que pueden emitirse entre dos widgets seleccionados

Para completar la conexión, selecciona una señal del objeto de origen y una ranura del objeto de destino y, a continuación, haz clic en Aceptar. Haz clic en Cancelar si deseas abandonar la conexión.

Nota: Si la casilla de verificación «Mostrar todas las señales y ranuras» está marcada, se mostrarán todas las señales disponibles del objeto de origen. De lo contrario, se ocultarán las señales y ranuras heredadas de QWidget.

Puede establecer tantas conexiones como desee entre los objetos del formulario; es posible conectar señales de objetos a ranuras del propio formulario. Como resultado, las conexiones de señales y ranuras de muchos cuadros de diálogo se pueden configurar por completo desde dentro de Qt Widgets Designer.

Captura de pantalla en la que se ve una flecha que sale de un widget y sigue al cursor para seleccionar el widget que recibe las señalesConexión a un formulario

Para conectar un objeto al propio formulario, basta con situar el cursor sobre el formulario y soltar el botón del ratón. El extremo de la conexión cambia al símbolo eléctrico de «tierra».

Editar y eliminar conexiones

Por defecto, las rutas de conexión se crean con dos etiquetas que indican la señal y la ranura implicadas en la conexión. Estas etiquetas suelen estar orientadas a lo largo de la línea de conexión. Puedes moverlas dentro de sus widgets de acogida arrastrando el cuadrado rojo situado en cada extremo de la ruta de conexión.

Captura de pantalla del editor de señales y ranuras de Qt Designer en la que se muestran las conexiones entre un «okButton» y un «cancelButton», en las que ambos envían una señal «clicked()». El «okButton» activa la función «accept()» y el «cancelButton», la función «reject()».El editor de señales y ranuras

La señal y la ranura utilizadas en una conexión se pueden modificar una vez que se ha establecido. Cuando se configura una conexión, esta se hace visible en el editor de señales y ranuras de Qt Widgets Designer, donde se puede seguir editando. También puedes editar las conexiones de señal/ranura haciendo doble clic en la ruta de conexión o en una de sus etiquetas para abrir el cuadro de diálogo de conexión.

Captura de pantalla que muestra el modo de edición de conexiones para modificar las señales entre dos widgetsEliminación de conexiones

Se puede seleccionar toda la conexión haciendo clic en cualquiera de sus segmentos de ruta. Una vez seleccionada, una conexión se puede eliminar con la tecla «Suprimir», lo que garantiza que no se configurará en el archivo de interfaz de usuario.

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