Connections QML Type

Décrit les connexions généralisées aux signaux. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

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

Description détaillée

Un objet Connections établit une connexion avec un signal QML.

Lorsqu'on se connecte à des signaux en QML, la méthode habituelle consiste à créer un gestionnaire « on<Signal> » qui réagit lorsqu'un signal est reçu, comme ceci :

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

Cependant, il n’est pas possible de se connecter à un signal de cette manière dans certains cas, notamment lorsque :

• Plusieurs connexions au même signal sont requises
• La création de connexions en dehors de la portée de l'émetteur du signal
• La connexion à des cibles non définies en QML

Lorsque l'une de ces situations se présente, on peut utiliser à la place le type Connections.

Par exemple, le code ci-dessus peut être modifié pour utiliser un objet « Connections », comme suit :

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

Plus généralement, l’objet Connections peut être un enfant d’un objet autre que l’émetteur du signal :

MouseArea {
    id: area
}
// ...

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

Voir aussi Qt Qml.

Documentation sur les propriétés

enabled : bool

Cette propriété indique si l'élément accepte les événements de modification.

Par défaut, cette propriété est définie sur « true ».

ignoreUnknownSignals : bool

En règle générale, une connexion à un signal inexistant génère des erreurs d'exécution.

Si cette propriété est définie sur « true », ces erreurs sont ignorées. Cela s'avère utile si vous prévoyez de vous connecter à différents types d'objets, en gérant un ensemble de signaux différent pour chaque objet.

target : QtObject

Cette propriété contient l'objet qui envoie le signal.

Si cette propriété n'est pas définie, l'target t par défaut le parent de la Connection.

Si elle est définie sur null, aucune connexion n'est établie et tous les gestionnaires de signaux sont ignorés jusqu'à ce que la cible ne soit plus null.