Connections QML Type

Beschreibt allgemeine Verbindungen zu Signalen. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Ausführliche Beschreibung

Ein Connections-Objekt stellt eine Verbindung zu einem QML-Signal her.

Beim Verbinden mit Signalen in QML wird üblicherweise ein „on<Signal>“-Handler erstellt, der reagiert, wenn ein Signal empfangen wird, etwa so:

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

In manchen Fällen ist es jedoch nicht möglich, auf diese Weise eine Verbindung zu einem Signal herzustellen, beispielsweise wenn:

• Mehrere Verbindungen zum selben Signal erforderlich sind
• Verbindungen außerhalb des Geltungsbereichs des Signalgebers erstellt werden
• Verbindungen zu Zielen hergestellt werden, die nicht in QML definiert sind

Wenn einer dieser Fälle vorliegt, kann stattdessen der Typ „Connections“ verwendet werden.

Beispielsweise lässt sich der obige Code wie folgt ändern, um ein „Connections“-Objekt zu verwenden:

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

Allgemeiner gesagt kann das „Connections“-Objekt ein untergeordnetes Objekt eines anderen Objekts als des Signalabsenders sein:

MouseArea {
    id: area
}
// ...

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

Siehe auch Qt Qml.

Dokumentation zu den Eigenschaften

enabled : bool

Diese Eigenschaft gibt an, ob das Element Änderungsereignisse akzeptiert.

Standardmäßig ist diese Eigenschaft auf „ true “ gesetzt.

ignoreUnknownSignals : bool

Normalerweise führt eine Verbindung zu einem nicht vorhandenen Signal zu Laufzeitfehlern.

Wenn diese Eigenschaft auf „ true “ gesetzt ist, werden solche Fehler ignoriert. Dies ist nützlich, wenn Sie eine Verbindung zu verschiedenen Objekttypen herstellen und für jedes Objekt unterschiedliche Signale verarbeiten möchten.

target : QtObject

Diese Eigenschaft enthält das Objekt, das das Signal sendet.

Wenn diese Eigenschaft nicht festgelegt ist, wird als „ target “ standardmäßig das übergeordnete Element der „Connection“ verwendet.

Wird der Wert auf „null“ gesetzt, wird keine Verbindung hergestellt und alle Signal-Handler werden ignoriert, bis das Ziel nicht mehr „null“ ist.