Connections QML Type

Décrit les connexions généralisées aux signaux. Plus d'informations...

• 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 crée une connexion à un signal QML.

Pour se connecter à des signaux en QML, la méthode habituelle consiste à créer un gestionnaire "on<Signal>" qui réagit à la réception d'un signal, 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, par exemple lorsque :

• Plusieurs connexions au même signal sont nécessaires
• la création de connexions en dehors du champ d'application de l'émetteur du signal
• Connexion à des cibles non définies dans QML

Lorsque l'une de ces situations est nécessaire, le type Connections peut être utilisé à la place.

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

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

Par défaut, cette propriété est true.

ignoreUnknownSignals : bool

Normalement, une connexion à un signal inexistant produit des erreurs d'exécution.

Si cette propriété vaut true, ces erreurs sont ignorées. Cette propriété est utile si vous avez l'intention de vous connecter à différents types d'objets, en gérant un ensemble différent de signaux 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'objet target est par défaut le parent de la connexion.

Si elle vaut null, aucune connexion n'est établie et les gestionnaires de signaux sont ignorés jusqu'à ce que la cible soit différente de null.