Sur cette page

Qt3DCore::QEntity Class

class Qt3DCore::QEntity

Qt3DCore::QEntity est une sous-classe de Qt3DCore::QNode qui peut regrouper plusieurs instances de Qt3DCore::QComponent qui spécifieront son comportement. Plus...

En-tête : #include <QEntity>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3DCore)
target_link_libraries(mytarget PRIVATE Qt6::3DCore)
qmake : QT += 3dcore
En QML : Entity
Hérite : Qt3DCore::QNode
Héritée par :

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

Status : Déclassé

Fonctions publiques

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)

Description détaillée

En soi, un objet Qt3DCore::QEntity est une coquille vide. Le comportement d'un objet Qt3DCore::QEntity est défini par les objets Qt3DCore::QComponent qu'il référence. Chaque aspect du backend Qt3D sera capable d'interpréter et de traiter une entité en reconnaissant les composants qui la composent. Un aspect peut décider de ne traiter que les entités composées d'un seul composant Qt3DCore::QTransform tandis qu'un autre peut se concentrer sur Qt3DInput::QMouseHandler.

Voir également Qt3DCore::QComponent et Qt3DCore::QTransform.

Documentation sur les fonctions des membres

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

Construit une nouvelle instance Qt3DCore::QEntity avec parent comme parent.

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

Ajoute une nouvelle référence au composant comp.

Remarque : si le composant Qt3DCore::QComponent n'a pas de parent, le composant Qt3DCore::QEntity se définira comme son parent et prendra ainsi possession du composant.

Qt3DCore::QComponentVector QEntity::components() const

Renvoie la liste des instances Qt3DCore::QComponent auxquelles l'entité fait référence.

template <typename T> QList<T *> QEntity::componentsOfType() const

Renvoie tous les composants ajoutés à cette entité qui peuvent être transformés en type T ou un vecteur vide s'il n'y a pas de tels composants.

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

Renvoie l'instance parentale Qt3DCore::QEntity de cette entité. Si le parent immédiat n'est pas Qt3DCore::QEntity, cette fonction remonte la hiérarchie de la scène jusqu'à ce qu'un parent Qt3DCore::QEntity soit trouvé. Si aucun parent Qt3DCore::QEntity n'est trouvé, elle renvoie null.

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

Supprime la référence à comp.

Non-membres apparentés

[alias] QComponentVector

Liste des pointeurs QComponent.

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