QEntity Class

class Qt3DCore::QEntity

Qt3DCore::QEntity ist eine Qt3DCore::QNode Unterklasse, die mehrere Qt3DCore::QComponent Instanzen zusammenfassen kann, die ihr Verhalten festlegen. Mehr...

Kopfzeile: #include <QEntity>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3DCore)
target_link_libraries(mytarget PRIVATE Qt6::3DCore)
qmake: QT += 3dcore
In QML: Entity
Vererbt: Qt3DCore::QNode
Geerbt von:

Qt3DExtras::QAbstractCameraController, Qt3DExtras::QSkyboxEntity, Qt3DExtras::QText2DEntity, und Qt3DRender::QCamera

Status: Veraltet

Ö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)

Detaillierte Beschreibung

Ein Qt3DCore::QEntity ist an sich eine leere Hülle. Das Verhalten eines Qt3DCore::QEntity Objekts wird durch die Qt3DCore::QComponent Objekte definiert, die es referenziert. Jeder Qt3D Backend Aspekt ist in der Lage, ein Entity zu interpretieren und zu verarbeiten, indem er erkennt, aus welchen Komponenten es sich zusammensetzt. Ein Aspekt kann entscheiden, nur Entities zu verarbeiten, die aus einer einzigen Qt3DCore::QTransform Komponente bestehen, während ein anderer sich auf Qt3DInput::QMouseHandler konzentrieren kann.

Siehe auch Qt3DCore::QComponent und Qt3DCore::QTransform.

Dokumentation der Mitgliedsfunktionen

[explicit] QEntity::QEntity(Qt3DCore::QNode *parent = nullptr)

Erzeugt eine neue Instanz von Qt3DCore::QEntity mit parent als übergeordnetem Element.

void QEntity::addComponent(Qt3DCore::QComponent *comp)

Fügt einen neuen Verweis auf die Komponente comp hinzu.

Hinweis: Wenn Qt3DCore::QComponent kein übergeordnetes Element hat, setzt sich Qt3DCore::QEntity selbst als übergeordnetes Element ein und übernimmt damit das Eigentum an der 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 zu dieser Entität hinzugefügten Komponenten zurück, die in den Typ T gecastet werden können, oder einen leeren Vektor, wenn es keine solchen Komponenten gibt.

Qt3DCore::QEntity *QEntity::parentEntity() const

Gibt die übergeordnete Qt3DCore::QEntity Instanz dieser Entität zurück. Wenn der unmittelbare Elternteil kein Qt3DCore::QEntity ist, durchläuft diese Funktion die Szenenhierarchie, bis ein Elternteil Qt3DCore::QEntity gefunden wird. Wenn kein Qt3DCore::QEntity Elternteil gefunden werden kann, wird null zurückgegeben.

void QEntity::removeComponent(Qt3DCore::QComponent *comp)

Entfernt den Verweis auf comp.

Verwandte Nicht-Mitglieder

[alias] QComponentVector

Liste von QComponent Zeigern.

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