QObjectRegistryRef Class
Diese Klasse dient dazu, aus C++-Code auf ein Objekt zuzugreifen, das beim QML-Typ „ ObjectRegistry “ registriert ist. Mehr...
| Header: | #include <QObjectRegistryRef> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS QmlDesignSupport) target_link_libraries(mytarget PRIVATE Qt6::QmlDesignSupport) |
| qmake: | QT += qmldesignsupport |
| Seit: | Qt 6.12 |
| In QML: | MultiObjectRegistryRef und ObjectRegistryRef |
| Erbt von: | QAbstractObjectRegistryRef |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QObjectRegistryRef ist Teil der „Qt Qml “-Design-Unterstützung für C++-Klassen.
Eigenschaften
- object : QObject*
Öffentliche Funktionen
| QObjectRegistryRef(QObject *parent = nullptr) | |
| QObjectRegistryRef(QQmlEngine *engine, QObject *parent = nullptr) | |
| QObjectRegistryRef(QQmlEngine *engine, const QString &key, QObject *parent = nullptr) | |
| QObject * | object() const |
Signale
| void | objectChanged(QObject *object) |
Neu implementierte geschützte Funktionen
| virtual bool | event(QEvent *event) override |
Detaillierte Beschreibung
Anwendungsbeispiel:
// Register object in a QML file
MouseArea {
ObjectRegistry.key: "MyMouseArea"
}
// In C++ code, refer to the registered object, using the QML engine you loaded the QML with
auto ref = new QObjectRegistryRef(engine, "MyMouseArea");
const auto object = ref->object();
connect(object, SIGNAL(clicked(QQuickMouseEvent*)),
this, SLOT(myClickHandler()));Siehe auch ObjectRegistry und QAbstractObjectRegistryRef::key.
Dokumentation der Eigenschaften
[read-only] object : QObject*
Diese Eigenschaft enthält das Objekt, auf das diese Instanz verweist.
Wenn mehrere Objekte unter demselben Schlüssel registriert sind, ist das von dieser Instanz referenzierte Objekt ein nicht näher bezeichnetes dieser Objekte. Verwenden Sie in diesem Fall stattdessen „ QMultiObjectRegistryRef “.
Zugriffsfunktionen:
| QObject * | object() const |
Notifier-Signal:
| void | objectChanged(QObject *object) |
Siehe auch „ ObjectRegistry “ und „ QAbstractObjectRegistryRef::key “.
Dokumentation der Mitgliedsfunktionen
[explicit] QObjectRegistryRef::QObjectRegistryRef(QObject *parent = nullptr)
Erstellt eine Instanz von `QObjectRegistryRef` mit ` parent`.
Hinweis: Verwenden Sie diesen Konstruktor nur, wenn die richtige QML-Engine beim Setzen des Schlüssels automatisch ermittelt wird. Dies ist in der Regel nicht der Fall, wenn eine Instanz dieser Klasse aus C++ heraus erstellt wird. Es wird empfohlen, einen der Konstruktoren zu verwenden, die einen Zeiger auf eine QML-Engine als Parameter entgegennehmen.
Siehe auch „ qmlEngine()“ und „ QAbstractObjectRegistryRef::key “.
[explicit] QObjectRegistryRef::QObjectRegistryRef(QQmlEngine *engine, QObject *parent = nullptr)
Erstellt eine Instanz von `QObjectRegistryRef` mit den QML- engine und parent. Alle Registrierungen gelten nur für die angegebene QML-Engine.
Siehe auch QAbstractObjectRegistryRef::key.
[explicit] QObjectRegistryRef::QObjectRegistryRef(QQmlEngine *engine, const QString &key, QObject *parent = nullptr)
Erstellt eine Instanz von `QObjectRegistryRef` mit den QML- engine: ` key ` und ` parent`. Alle Registrierungen gelten nur für die angegebene QML-Engine.
Siehe auch QAbstractObjectRegistryRef::key.
[override virtual protected] bool QObjectRegistryRef::event(QEvent *event)
Umsetzt: ` QAbstractObjectRegistryRef::event(QEvent *event)`.
© 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.
