Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

Qt3DCore::QNode Class

class Qt3DCore::QNode

QNode ist die Basisklasse aller Qt3D-Knotenklassen, die zum Erstellen einer Qt3D-Szene verwendet werden. Mehr...

Header: #include <QNode>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3DCore)
target_link_libraries(mytarget PRIVATE Qt6::3DCore)
qmake: QT += 3dcore
Erbt von: QObject
Vererbt an:
32 Typen

Qt3DAnimation::QAbstractAnimationClip, Qt3DAnimation::QAbstractClipBlendNode, Qt3DAnimation::QChannelMapper, Qt3DCore::QAbstractSkeleton, Qt3DCore::QAttribute, Qt3DCore::QBuffer, Qt3DCore::QComponent, Qt3DCore::QEntity, Qt3DCore::QGeometry, Qt3DCore::QGeometryView, Qt3DCore::QJoint, Qt3DInput::QAbstractActionInput, Qt3DInput::QAbstractAxisInput, Qt3DInput::QAbstractPhysicalDevice, Qt3DInput::QAction, Qt3DInput::QAxis, Qt3DInput::QAxisSetting, Qt3DRender::QAbstractTexture, Qt3DRender::QAbstractTextureImage, Qt3DRender::QEffect, Qt3DRender::QFilterKey, Qt3DRender::QFrameGraphNode, Qt3DRender::QParameter, Qt3DRender::QPickingSettings, Qt3DRender::QRenderPass, Qt3DRender::QRenderState, Qt3DRender::QRenderTargetOutput, Qt3DRender::QShaderImage, Qt3DRender::QShaderProgram, Qt3DRender::QShaderProgramBuilder, Qt3DRender::QTechnique sowie Qt3DRender::Quick::QScene2D

Status: Veraltet

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Eigenschaften

Öffentliche Funktionen

QNode(Qt3DCore::QNode *parent = nullptr)
bool blockNotifications(bool block)
Qt3DCore::QNodeVector childNodes() const
Qt3DCore::QNodeId id() const
bool isEnabled() const
bool notificationsBlocked() const
Qt3DCore::QNode *parentNode() const

Öffentliche Slots

void setEnabled(bool isEnabled)
void setParent(Qt3DCore::QNode *parent)

Signale

void enabledChanged(bool enabled)
void nodeDestroyed()
void parentChanged(QObject *parent)
QNodePtr
QNodeVector
Qt3DCore::QNodeId qIdForNode(Qt3DCore::QNode *node)
Qt3DCore::QNodeIdVector qIdsForNodes(const T &nodes)

Detaillierte Beschreibung

Die Zugehörigkeit eines QNode wird durch die „ QObject “-Eltern-Kind-Beziehung zwischen den Knoten bestimmt. Ein QNode hat an sich keine visuelle Darstellung und keine besondere Bedeutung; er dient lediglich dazu, eine auf Knoten basierende Baumstruktur aufzubauen.

Der übergeordnete Knoten einer QNode-Instanz kann nur eine andere QNode-Instanz sein.

Jede QNode-Instanz verfügt über eine eindeutige ID, anhand derer sie von anderen Instanzen unterschieden werden kann.

Wenn Eigenschaften in einer QNode-Unterklasse definiert werden, generiert deren NOTIFY-Signal automatisch Benachrichtigungen, die von den Qt3D-Backend-Komponenten empfangen werden.

Siehe auch QEntity und QComponent.

Dokumentation zu Eigenschaften

enabled : bool

Enthält das Flag „ QNode enabled“. Standardmäßig ist ein „ QNode “ immer aktiviert.

Hinweis: Die Interpretation dessen, was „enabled“ bedeutet, ist aspektabhängig. Selbst wenn „enabled“ auf „ false “ gesetzt ist, können einige Aspekte den Knoten dennoch in gewisser Weise berücksichtigen. Dies wird für jede Klasse einzeln dokumentiert.

Zugriffsfunktionen:

bool isEnabled() const
void setEnabled(bool isEnabled)

Notifier-Signal:

void enabledChanged(bool enabled)

parent : Qt3DCore::QNode*

Enthält den direkten übergeordneten Knoten QNode oder null, wenn der Knoten keinen übergeordneten Knoten hat.

Durch das Festlegen des übergeordneten Knotens werden die Backend-Aspekte über die Änderung des übergeordneten Knotens der aktuellen „ QNode “-Instanz benachrichtigt.

Hinweis: Sollte „ parent “ zufällig null sein, wird dadurch tatsächlich gemeldet, dass die aktuelle „ QNode “-Instanz aus der Szene entfernt wurde.

Zugriffsfunktionen:

Qt3DCore::QNode *parentNode() const
void setParent(Qt3DCore::QNode *parent)

Notifier-Signal:

void parentChanged(QObject *parent)

Dokumentation der Member-Funktionen

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

Erstellt eine neue QNode-Instanz mit dem übergeordneten Knoten „ parent “.

Hinweis: Die Backend-Komponenten werden nur dann darüber informiert, dass eine QNode-Instanz Teil der Szene ist, wenn sie einen übergeordneten Knoten hat; es sei denn, es handelt sich um den Stammknoten der Qt3D-Szene.

Siehe auch ` setParent()`.

bool QNode::blockNotifications(bool block)

Wenn „ block “ den Wert „ true “ hat, werden die von diesem Objekt an Aspekte gesendeten Benachrichtigungen über Eigenschaftsänderungen blockiert. Wenn „ block “ den Wert „ false “ hat, findet keine solche Blockierung statt.

Der Rückgabewert ist der vorherige Wert von ` notificationsBlocked()`.

Beachten Sie, dass die anderen Benachrichtigungstypen auch dann gesendet werden, wenn die Benachrichtigungen für dieses Objekt blockiert wurden.

Siehe auch ` notificationsBlocked()`.

Qt3DCore::QNodeVector QNode::childNodes() const

Gibt eine Liste zurück, die mit den „ QNode “-Unterelementen der aktuellen „ QNode “-Instanz gefüllt ist.

Qt3DCore::QNodeId QNode::id() const

Gibt die ID zurück, die die Instanz von „ QNode “ eindeutig identifiziert.

[signal] void QNode::nodeDestroyed()

Wird ausgelöst, wenn der Knoten zerstört wird.

bool QNode::notificationsBlocked() const

Gibt „ true “ zurück, wenn Aspektbenachrichtigungen blockiert sind; andernfalls wird „ false “ zurückgegeben. Standardmäßig werden Benachrichtigungen nicht blockiert.

Siehe auch „ blockNotifications()“.

Verwandte Nicht-Mitglieder

[alias] QNodePtr

Ein Shared Pointer für „ QNode “.

[alias] QNodeVector

Liste der Hinweise zu „ QNode “.

Qt3DCore::QNodeId qIdForNode(Qt3DCore::QNode *node)

Gibt die Knoten-ID für „ node “ zurück.

template <typename T> Qt3DCore::QNodeIdVector qIdsForNodes(const T &nodes)

Gibt einen Vektor mit Knoten-IDs für „ nodes “ zurück.

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