En esta página

Qt3DCore::QEntity Class

class Qt3DCore::QEntity

Qt3DCore::QEntity Es una subclase de « Qt3DCore::QNode » que puede agregar varias instancias de « Qt3DCore::QComponent » que determinarán su comportamiento. Más información...

Encabezado: #include <QEntity>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3DCore)
target_link_libraries(mytarget PRIVATE Qt6::3DCore)
qmake: QT += 3dcore
En QML: Entity
Heredado de: Qt3DCore::QNode
Heredado por:

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

Estado: Obsoleto

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Funciones públicas

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)

Descripción detallada

Por sí sola, una entidad ( Qt3DCore::QEntity ) es una estructura vacía. El comportamiento de un objeto de entidad ( Qt3DCore::QEntity ) viene definido por los objetos de fondo ( Qt3DCore::QComponent ) a los que hace referencia. Cada aspecto del backend de Qt3D podrá interpretar y procesar una entidad reconociendo de qué componentes está compuesta. Un aspecto puede decidir procesar únicamente entidades compuestas por un único componente de fondo ( Qt3DCore::QTransform ), mientras que otro puede centrarse en el componente de fondo de la entidad ( Qt3DInput::QMouseHandler).

Véase también Qt3DCore::QComponent y Qt3DCore::QTransform.

Documentación de funciones de miembro

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

Crea una nueva instancia de ` Qt3DCore::QEntity ` con ` parent ` como padre.

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

Añade una nueva referencia al componente ` comp`.

Nota: Si el Qt3DCore::QComponent no tiene ningún componente padre, el Qt3DCore::QEntity se establecerá a sí mismo como su padre, asumiendo así la propiedad del componente.

Qt3DCore::QComponentVector QEntity::components() const

Devuelve la lista de instancias de Qt3DCore::QComponent a las que hace referencia la entidad.

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

Devuelve todos los componentes añadidos a esta entidad que puedan convertirse al tipo T o un vector vacío si no hay ningún componente de ese tipo.

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

Devuelve la instancia « Qt3DCore::QEntity » principal de esta entidad. Si el elemento principal inmediato no es un « Qt3DCore::QEntity », esta función recorre la jerarquía de la escena hacia arriba hasta encontrar un elemento principal « Qt3DCore::QEntity ». Si no se encuentra ningún elemento principal « Qt3DCore::QEntity », devuelve null.

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

Elimina la referencia a comp.

Personas no afiliadas relacionadas

[alias] QComponentVector

Lista de punteros a 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.