Connections QML Type

Describe conexiones generalizadas a señales. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• enabled : bool
• ignoreUnknownSignals : bool
• target : QtObject

Descripción detallada

Un objeto Connections crea una conexión a una señal QML.

Cuando se conecta a señales en QML, lo habitual es crear un manejador "on<Signal>" que reaccione cuando se recibe una señal, como éste:

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

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

• Se requieren múltiples conexiones a la misma señal
• se crean conexiones fuera del ámbito del emisor de la señal
• Conexión a objetivos no definidos en QML

Cuando se necesite cualquiera de estos casos, se puede utilizar el tipo Conexiones en su lugar.

Por ejemplo, el código anterior puede modificarse para utilizar un objeto Conexiones, como se muestra a continuación:

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

De forma más general, el objeto Conexiones puede ser hijo de algún objeto que no sea el emisor de la señal:

MouseArea {
    id: area
}
// ...

Connections {
    target: area
    function onClicked(mouse) { foo(mouse) }
}

Véase también Qt Qml.

Documentación de propiedades

enabled : bool

Esta propiedad indica si el elemento acepta eventos de cambio.

Por defecto, esta propiedad es true.

ignoreUnknownSignals : bool

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

Si esta propiedad se establece en true, tales errores se ignoran. Esto es útil si pretende conectarse a diferentes tipos de objetos, manejando un conjunto diferente de señales para cada objeto.

target : QtObject

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

Si no se establece esta propiedad, la dirección target será por defecto el padre de la Conexión.

Si se establece en null, no se establece ninguna conexión y se ignoran los manejadores de señal hasta que el objetivo no sea null.