QComponent Class

class Qt3DCore::QComponent

The base class of scene nodes that can be aggregated by Qt3DCore::QEntity instances as a component. More...

This class was introduced in Qt 5.5.

Properties

Public Functions

QComponent(QNode *parent = nullptr)
QVector<QEntity *> entities() const
bool isShareable() const

Public Slots

void setShareable(bool isShareable)

Signals

void addedToEntity(QEntity *entity)
void removedFromEntity(QEntity *entity)
void shareableChanged(bool isShareable)

Detailed Description

A Qt3DCore::QComponent provides a vertical slice of behavior that can be assigned to and sometimes shared across Qt3DCore::QEntity instances.

Qt3DCore::QComponent subclasses are often aggregated in groups that impart useful behavior to the aggregating entity. For example, to have an Entity that gets drawn by the Qt3D renderer aspect, an entity would most likely aggregate Qt3DCore::QTransform, Qt3DRender::QMesh, and Qt3DRender::QMaterial components.

See also Qt3DCore::QEntity.

Property Documentation

isShareable : bool

Holds the shareable flag of the QComponent. The QComponent can be shared across several entities if true.

Access functions:

bool isShareable() const
void setShareable(bool isShareable)

Notifier signal:

void shareableChanged(bool isShareable)

Member Function Documentation

QComponent::QComponent(QNode *parent = nullptr)

Constructs a new QComponent instance with parent as the parent.

Note: a QComponent should never be instanced directly, instance one of the subclasses instead.

[signal] void QComponent::addedToEntity(QEntity *entity)

Indicates that a reference has been added to entity.

[signal] void QComponent::removedFromEntity(QEntity *entity)

Indicates that a reference has been removed from entity.

QVector<QEntity *> QComponent::entities() const

Returns a QVector containing all the entities that reference this component.