ObjectRegistry QML Type

Dieser Typ dient dazu, Objekte anhand einer Schlüsselzeichenfolge für den späteren Zugriff zu registrieren. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder
• „ObjectRegistry“ ist Teil der „Qt Qml -Design-Support-QML-Typen“.

Eigenschaften

• key : string
• target : QtObject

Ausführliche Beschreibung

Das Objektregister stellt eine QML-Engine-weite Referenz für Objekte bereit. Sie registrieren jedes Objekt mit einem String-Schlüssel, den Sie später verwenden können, um das Objekt über einen der folgenden Referenztypen abzurufen: ObjectRegistryRef und MultiObjectRegistryRef. Für den Zugriff auf registrierte Objekte stehen außerdem C++-Klassen zur Verfügung: QObjectRegistryRef und QMultiObjectRegistryRef.

Derselbe Schlüssel kann zur Registrierung mehrerer Objekte verwendet werden. Ein typischer Anwendungsfall hierfür ist die Registrierung eines Listen- oder Repeater-Delegaten.

Das registrierte Objekt wird automatisch aus der Registrierung entfernt, sobald entweder das Objekt oder die ObjectRegistry-Instanz zerstört wird. Durch Ändern des Zielobjekts oder des Schlüssels wird die alte Kombination aus der Registrierung entfernt.

Registrieren Sie dieselbe Kombination aus Objekt und Schlüssel nicht mehr als einmal. Pro Kombination wird nur eine Registrierung gespeichert.

Die Registrierung kann entweder über eine angehängte Eigenschaft des registrierten Objekts oder mithilfe eines separaten „ObjectRegistry“-Objekts mit Ziel und Schlüssel erfolgen:

// Registering with attached property
Item {
    id: itemToRegister
    ObjectRegistry.key: "MyItem"
}

// Registering with separate ObjectRegistry object
Item {
    id: itemToRegister
    ObjectRegistry {
        target: itemToRegister
        key: "MyItem"
    }
}

Siehe auch ObjectRegistryRef, MultiObjectRegistryRef, QObjectRegistryRef und QMultiObjectRegistryRef.

Dokumentation zu Eigenschaften

key : string

Diese Eigenschaft gibt den Schlüssel des registrierten Objekts an.

target : QtObject

Diese Eigenschaft gibt das zu registrierende Zielobjekt an.

Wird das Zielobjekt zerstört, wird diese Eigenschaft auf null zurückgesetzt.