En esta página

Connections QML Type

Describe las conexiones generales con las señales. Más...

Import Statement: import QtQml

Propiedades

Descripción detallada

Un objeto Connections establece una conexión con una señal QML.

Al conectarse a señales en QML, lo habitual es crear un controlador «on<Signal>» que reaccione cuando se reciba una señal, de la siguiente manera:

MouseArea {
    onClicked: (mouse)=> { foo(mouse) }
}

Sin embargo, en algunos casos no es posible conectarse a una señal de esta forma, como por ejemplo cuando:

  • Se requieren varias conexiones a la misma señal
  • Se crean conexiones fuera del ámbito del emisor de la señal
  • Se conecta a destinos no definidos en QML

Cuando sea necesario cualquiera de estos casos, se puede utilizar en su lugar el tipo Connections.

Por ejemplo, el código anterior se puede modificar para utilizar un objeto «Connections», de la siguiente manera:

MouseArea {
    Connections {
        function onClicked(mouse) { foo(mouse) }
    }
}

En términos más generales, el objeto «Connections» puede ser un elemento secundario de algún objeto distinto del emisor de la señal:

MouseArea {
    id: area
}
// ...
Connections {
    target: area
    function onClicked(mouse) { foo(mouse) }
}

Nota: Para garantizar la compatibilidad con versiones anteriores, también se pueden especificar los controladores de señal sin function, tal y como se especificarían directamente en el objeto de destino. Esto no se recomienda. Si se especifica un controlador de señal de esta manera, se ignorarán todos los controladores de señal especificados como function en el mismo objeto «Connections».

Véase también Qt Qml.

Documentación de propiedades

enabled : bool

Esta propiedad indica si el elemento admite eventos de cambio.

Por defecto, esta propiedad tiene el valor « true ».

ignoreUnknownSignals : bool

Normalmente, una conexión a una señal inexistente provoca errores en tiempo de ejecución.

Si esta propiedad se establece en « true », dichos errores se ignoran. Esto resulta útil si se pretende conectarse a diferentes tipos de objetos, gestionando un conjunto diferente de señales para cada objeto.

target : QtObject

Esta propiedad contiene el objeto que envía la señal.

Si esta propiedad no se establece, el ` target ` toma por defecto el padre de la `Connection`.

Si se establece en null, no se establece ninguna conexión y se ignoran todos los controladores de señales hasta que el destino deje de ser null.

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