Qt3DCore::QEntity Class
class Qt3DCore::QEntityQt3DCore::QEntity ist eine Unterklasse von „ Qt3DCore::QNode “, die mehrere „ Qt3DCore::QComponent “-Instanzen aggregieren kann, die ihr Verhalten festlegen. Mehr...
| Header: | #include <QEntity> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3DCore) target_link_libraries(mytarget PRIVATE Qt6::3DCore) |
| qmake: | QT += 3dcore |
| In QML: | Entity |
| Erbt von: | Qt3DCore::QNode |
| Vererbt an: | Qt3DExtras::QAbstractCameraController, „ Qt3DExtras::QSkyboxEntity “, „ Qt3DExtras::QText2DEntity “ und Qt3DRender::QCamera |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Öffentliche Funktionen
| QEntity(Qt3DCore::QNode *parent = nullptr) | |
| void | addComponent(Qt3DCore::QComponent *comp) |
| Qt3DCore::QComponentVector | components() const |
| QList<T *> | componentsOfType() const |
| Qt3DCore::QEntity * | parentEntity() const |
| void | removeComponent(Qt3DCore::QComponent *comp) |
Verwandte Nicht-Mitglieder
Ausführliche Beschreibung
Für sich genommen ist eine „ Qt3DCore::QEntity “ eine leere Hülle. Das Verhalten eines „ Qt3DCore::QEntity “-Objekts wird durch die „ Qt3DCore::QComponent “-Objekte definiert, auf die es verweist. Jeder Qt3D-Backend-Aspekt ist in der Lage, eine „Entity“ zu interpretieren und zu verarbeiten, indem er erkennt, aus welchen Komponenten sie besteht. Ein Aspekt kann sich beispielsweise dafür entscheiden, nur Entitäten zu verarbeiten, die aus einer einzigen „ Qt3DCore::QTransform “-Komponente bestehen, während sich ein anderer auf „ Qt3DInput::QMouseHandler “ konzentriert.
Siehe auch Qt3DCore::QComponent und Qt3DCore::QTransform.
Dokumentation der Mitgliedsfunktionen
[explicit] QEntity::QEntity(Qt3DCore::QNode *parent = nullptr)
Erstellt eine neue Instanz von „ Qt3DCore::QEntity “ mit „ parent “ als übergeordneter Instanz.
void QEntity::addComponent(Qt3DCore::QComponent *comp)
Fügt eine neue Referenz zur Komponente „ comp “ hinzu.
Hinweis: Wenn die `Qt3DCore::QComponent` keinen übergeordneten Element hat, setzt sich die ` Qt3DCore::QEntity ` selbst als übergeordnetes Element und übernimmt damit die Verantwortung für die Komponente.
Qt3DCore::QComponentVector QEntity::components() const
Gibt die Liste der Qt3DCore::QComponent-Instanzen zurück, auf die die Entität verweist.
template <typename T> QList<T *> QEntity::componentsOfType() const
Gibt alle dieser Entität hinzugefügten Komponenten zurück, die in den Typ T umgewandelt werden können, oder einen leeren Vektor, falls keine solchen Komponenten vorhanden sind.
Qt3DCore::QEntity *QEntity::parentEntity() const
Gibt die übergeordnete „ Qt3DCore::QEntity “-Instanz dieser Entität zurück. Ist die unmittelbar übergeordnete Instanz kein „ Qt3DCore::QEntity “, durchläuft diese Funktion die Szenenhierarchie nach oben, bis ein übergeordnetes „ Qt3DCore::QEntity “ gefunden wird. Kann kein übergeordnetes „ Qt3DCore::QEntity “ gefunden werden, wird null zurückgegeben.
void QEntity::removeComponent(Qt3DCore::QComponent *comp)
Entfernt den Verweis auf comp.
© 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.
