ObjectRegistry QML Type

Ce type sert à enregistrer des objets afin de pouvoir y accéder ultérieurement à l'aide d'une chaîne de caractères comme clé. En savoir plus...

• Liste de tous les membres, y compris les membres hérités
• ObjectRegistry fait partie des types QML de l'Qt Qml Design Support.

Propriétés

• key : string
• target : QtObject

Description détaillée

Le registre d'objets fournit une référence à l'échelle du moteur QML pour les objets. Vous enregistrez chaque objet à l'aide d'une clé de type chaîne de caractères, que vous pouvez utiliser ultérieurement pour récupérer l'objet via l'un des types de référence suivants : ObjectRegistryRef et MultiObjectRegistryRef. Des classes C++ sont également fournies pour accéder aux objets enregistrés : QObjectRegistryRef et QMultiObjectRegistryRef.

Une même clé peut être utilisée pour enregistrer plusieurs objets. Un cas d’utilisation typique consiste à enregistrer une liste ou un délégué de répétiteur.

L’objet enregistré est automatiquement supprimé du registre soit lors de la destruction de l’objet, soit lors de la destruction de l’instance ObjectRegistry. La modification de l’objet cible ou de la clé supprime l’ancienne combinaison du registre.

N’enregistrez pas la même combinaison objet-clé plus d’une fois. Un seul enregistrement par combinaison est conservé.

L’enregistrement peut s’effectuer soit via une propriété attachée à l’objet enregistré, soit à l’aide d’un objet `ObjectRegistry` distinct avec la cible et la clé :

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

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

Voir également ObjectRegistryRef, MultiObjectRegistryRef, QObjectRegistryRef et QMultiObjectRegistryRef.

Documentation sur les propriétés

key : string

Cette propriété spécifie la clé de l'objet enregistré.

target : QtObject

Cette propriété spécifie l'objet cible à enregistrer.

Si l'objet cible est détruit, cette propriété est réinitialisée à null.