Auf dieser Seite

MultiObjectRegistryRef QML Type

Dieser Typ dient zum Zugriff auf Objekte, die mit dem Typ „ ObjectRegistry “ registriert sind. Mehr...

Import Statement: import QtQml.DesignSupport
Since: Qt 6.12
In C++: QObjectRegistryRef
Inherits:

AbstractObjectRegistryRef

Eigenschaften

Signale

Ausführliche Beschreibung

Über diese Referenz kann auf mehrere Objekte zugegriffen werden, die mit demselben Schlüssel registriert sind.

Anwendungsbeispiel:

// In a QML file, register something that gets created multiple times (e.g. a repeater delegate)
Repeater {
    model: 4
    Rectangle {
        id: qmlRepeaterDelegate
        required property int index
        x: 50 * index
        width: 40
        height: 40
        MouseArea {
            property int repeaterIndex: qmlRepeaterDelegate.index
            anchors.fill: parent
            ObjectRegistry.key: "RepeatedMouseArea"
        }
    }
}

// In another QML file, refer to the registered objects
MultiObjectRegistryRef {
    id: repeaterRef
    key: "RepeatedMouseArea"

    onObjectAdded: (object)=> {
        // Connect each object's clicked signal as they are added
        object.clicked.connect(function (mouse) { clickedHandler(object); })
    }

    function clickedHandler(object) {
        console.log("Index clicked: " + object.repeaterIndex)
    }
}

Siehe auch ObjectRegistry und AbstractObjectRegistryRef::key.

Dokumentation zu den Eigenschaften

objects : list<QtObject>

Diese Eigenschaft stellt die Objekte bereit, auf die diese Instanz verweist. Es wird nicht garantiert, dass die Reihenfolge der Objekte in dieser Liste mit der Reihenfolge ihrer Registrierung übereinstimmt.

Siehe auch ObjectRegistry und AbstractObjectRegistryRef::key.

Signal-Dokumentation

objectAdded(QtObject obj)

Dieses Signal wird ausgelöst, wenn ein neues Objekt, obj, unter dem Schlüssel dieser Referenz registriert wurde.

Hinweis: Der entsprechende Handler lautet onObjectAdded.

objectRemoved(QtObject obj)

Dieses Signal wird ausgelöst, wenn die Registrierung eines Objekts ( obj) unter dem Schlüssel dieser Referenz entfernt wurde.

Hinweis: Wenn das Entfernen der Registrierung durch das Löschen des Objekts ausgelöst wurde, ist der Parameter ` obj ` null, da QML ein Objekt, das gerade gelöscht wird, nicht auflösen kann.

Hinweis: Der entsprechende Handler ist „ onObjectRemoved “.

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